babble - Simplistic Babble frontend

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.