NAME

Babble::Theme::planet_ttk - Planet inspired theme for Babble

DESCRIPTION

The planet theme was inspired by the http://www.planetapache.org/ and http://planet.twistedmatrix.com/ sites. Being a Template Toolkit based theme, it is quite powerful, and offers a lot of features.

TEMPLATE VARIABLES

The following variables are used by the template (variables coming from Babble::Document or Babble::Document::Collection sources are not listed here!)

meta_title

The title of the Babble

meta_blurb_text

Optional extra text in the banner are.

meta_desc

Optional description of the babble.

meta_css_link

Optional, but recommended, link to the CSS stylesheet to use. Defaults to planet_ttk.css.

meta_charset

Optional charset.

meta_about_text

A few words about the Babble. If not specified, a default text is used.

meta_owner_email

E-Mail address of the Babble maintainer.

meta_owner

Name of the Babble maintainer.

meta_feed_text

Optional text in the feed area. If not specified, a default text is used.

meta_feed_link

Link to the feed the Babble provides.

TEMPLATE KNOBS

template_knob_no_sources

Turn off generating the Subscriptions area in the sidebar.

template_knob_datebar

Add a so-called datebar to the sidebar. This will contain local links to each date an entry is available for. Handy when the collection spans more than a few days.

template_knob_planetarium

Enables the Planetarium, a link collection to related or unrelated sites (Babbles, planets and the like). When enabled, a planetarium paramater must be made available to the template. This should contain an array of hashes. The layout should be as follows:

planetarium => [ { name => 'Example', url => 'http://example.org/' } ]

template_knob_no_date_head

Disables generating anchors (and headings) for each day.

template_knob_no_content_links

Disables linking to the entry sources. This is very handy when one wants to generate a front page with news items, or when one is using Babble to generate an original blog, instead of an aggregation.

template_knob_no_date

By default, after each entry, this theme places its submission date. This can be turned off with this knob.

METHODS

output()

This method sets up parameters for the Babble::Output::TTK->output method. It recognises only the -format option, which determines which output format is used. Currently html, foaf and opml are provided by the template.

AUTHOR

Gergely Nagy, algernon@bonehunter.rulez.org

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

SEE ALSO

Babble::Theme, Babble::Output::TTk