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

Babble documentation Contained in the Babble distribution.

Index

Code Index:

NAME

Top

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

DESCRIPTION

Top

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

Top

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.

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.

Link to the feed the Babble provides.

TEMPLATE KNOBS

Top

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

Top

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

Top

Gergely Nagy, algernon@bonehunter.rulez.org

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

SEE ALSO

Top

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

Babble documentation Contained in the Babble distribution. 
## Babble/Theme/planet_gray.pm
## Copyright (C) 2004 Gergely Nagy <algernon@bonehunter.rulez.org>
##
## This file is part of Babble.
##
## Babble is free software; you can redistribute it and/or modify it
## under the terms of the GNU General Public License as published by
## the Free Software Foundation; version 2 dated June, 1991.
##
## Babble is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
## FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
## for more details.
##
## You should have received a copy of the GNU General Public License
## along with this program; if not, write to the Free Software
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

package Babble::Theme::planet_gray;

use strict;

use Date::Manip;

use Babble::Theme;
use Babble::Output::TTk;

use Exporter ();
use vars qw(@ISA);
@ISA = qw(Babble::Theme);


sub output {
	my ($self, $babble, $params) = @_;

	$params->{-format} = "html" unless $params->{-format};

	$self->_merge_params
		($babble, $params,
		 {
			 -template => $self->_find_template ('planet_gray',
						     $params->{-format}),
			 meta_css_link => "planet_gray.css",
			 UnixDate => \&UnixDate
		 }
	 );

	return Babble::Output::TTk->output ($babble, $params);
}


1;

# arch-tag: 60a05dc2-c29d-4fb5-bef5-44a90098594f