NAME

babble - Simplistic Babble frontend

SYNOPSIS

babble [options] [configfile]

DESCRIPTION

The babble script is a simple wrapper around the core functionality of Babble. It can read a config file, which defines an aggregation and a set of output templates. Using this information, the script will generate static output.

OPTIONS

--debug

Enable debugging output, slightly more verbose than --verbose.

--help

Display a help message and exit.

--verbose

Enable verbose mode, printing the current state of processing.

--version

Print version information and exit.

CONFIG FILE SYNTAX

The configuration file syntax is pretty easy and straightforward. There are a few special sections, and so-called feed sections. The first and most important section is Babble, which describes the current babble's basic properties. The script recognises the output_dir and themes variables under this section. All other variables will be used as parameters in the created Babble object.

Then, there are the so-called theme descriptor sections. They all begin with a theme: prefix, and the rest is one of the items in the Babble section's themes variable. That is, if the configration file says something like this:

[Babble]
themes = html rss20

Then the two recognised theme descriptor sections are theme:html and theme:rss20. Each of these sections can contain a theme variable (defaults to the name of the theme, ie html and rss20 in our example), which specifies the theme to use; formats, which selects the formats to use (some themes provide multiple output formats); and output, the name of the output file.

EXAMPLE

[Babble]
themes = html rss20
output_dir = output
cache_db = feed_cache.db

[theme:html]
theme = planet_gray
output = index.html

[theme:rss20]
theme = XML
output = rss20.xml

AUTHOR

Gergely Nagy, algernon@bonehunter.rulez.org

Bugs should be reported at http://bugs.bonehunter.rulez.org/babble.

SEE ALSO

Babble, babble-cache