NAME

Blosxom Plug-in: storytitle

SYNOPSIS

Allows you to include the story title in the page header for individually viewed blosxom stories.

QUICK START

Put storytitle in your plug-ins directory.

Alter the formatting if desired, see "OPTIONS".

Finally place $storytitle::page_title in your <title> tag in head.flavour where you want to display the story title, something like this:

  <title>$blog_title $storytitle::page_title</title>

OPTIONS

Separator

If required change the $sep variable. This controls the separator that goes at the start of the story title, and between path entries for categories and archives. E.g. if $sep is ' : ' and the story title is 'A blosxom entry' then $storytitle::page_title will return ' : A blosxom entry'. If the category path is Categories/Blosxom then the plugin will return ' : Categories : Blosxom'.

Now all individually displayed stories can have their title in the pages title tag, or anywhere else in the page header you want. Just place $storytitle::page_title anywhere in the flavours where you want to display the story title.

Left and right aligned titles

If you have a need for a left aligned title (e.g. you want to have 'story title : blog title') there are two ways to achieve it:

You can also individually configure the left and right sided separators with the $left_sep and $right_sep configuration options. $storytitle::page_title_left will have $left_sep appended on the right, and $storytitle::page_title_right will have $right_set prepended to the left. If they are not set, they both default to $sep.

VERSION

0.7

CHANGES

0.7 - Provide title for Category pages as well as Stories and Archive pages. - Also included rus.berrett's patch to remove formatting, from http://rus.berrett.org/blog/contrib/blosxom/storytitle_plugin.html

0.6 - Now uses the users file extension setting rather than always .txt

0.5 - deals with filenames with like foo.bar.txt and foo-bar.txt (thanks to Antti Vähä-Sipilä for pointing this out) catches titles containing only white space.

0.4 - bugfix to stop title values hanging around under static generation

0.3 - fixed left_title to actually be a left title

0.2 - introduced left and right options

AUTHOR

Struan Donald <code@exo.org.uk>, http://exo.org.uk/code/

CREDITS

Lim Chee Aun http://phoenity.com/ for the left/right sided titles idea.

Anthony DeLorenzo <anthony.delorenzo@gmail.com> for fix to make it use the users file extension setting.

Rus Berrett http://rus.berrett.org/blog/ for patch to remove formatting.

Nick Leverton <nick@leverton.org>, http://www.leverton.org/blosxom for Category page titles.

SEE ALSO

Blosxom Home/Docs/Licensing: http://blosxom.sourceforge.net/

Blosxom Plugin Docs: http://blosxom.sourceforge.net/documentation/users/plugins.html

COPYRIGHT

Copyright (C) 2003-2005 Struan Donald.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.