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

NAME

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

DESCRIPTION

The planet_gray 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.

template_knob_with_image

If a feed comes with an associated image, the planet theme can display this image, provided this knob is enabled.

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 only html is provided by the template.

Currently, -format defaults to html.

AUTHOR

Gergely Nagy, algernon@bonehunter.rulez.org