Gergely Nagy > Babble > babble

Download:
Babble-0.07.tar.gz

Annotate this POD

View/Report Bugs
Source  

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

syntax highlighting: