# What's this blog's primary language (for outgoing RSS feed)?
$blog_language = "en";
# What's this blog's text encoding ?
$blog_encoding = "UTF-8";
# Where are this blog's entries kept?
$datadir = "/var/local/jason/Documents/blog";
# What's my preferred base URL for this blog (leave blank for automatic)?
$url = "";
# Should I stick only to the datadir for items or travel down the
# directory hierarchy looking for items? If so, to what depth?
# 0 = infinite depth (aka grab everything), 1 = datadir only, n = n levels down
$depth = 0;
# How many entries should I show on the home page?
$num_entries = 40;
# What file extension signifies a blosxom entry?
$file_extension = "txt";
# What is the default flavour?
$default_flavour = "html";
# Should I show entries from the future (i.e. dated after now)?
$show_future_entries = 0;
# --- Plugins (Optional) -----
# File listing plugins blosxom should load
# (if empty blosxom will load all plugins in $plugin_dir and $plugin_path directories)
$plugin_list = "";
# Where are my plugins kept?
$plugin_dir = "";
# Where should my plugins keep their state information?
$plugin_state_dir = "$plugin_dir/state";
# Additional plugins location
# List of directories, separated by ';' on windows, ':' everywhere else
$plugin_path = "";
# --- Static Rendering -----
# Where are this blog's static files to be created?
$static_dir = "/Library/WebServer/Documents/blog";
# What's my administrative password (you must set this for static rendering)?
$static_password = "";
# What flavours should I generate statically?
@static_flavours = qw/html rss/;
# Should I statically generate individual entries?
# 0 = no, 1 = yes
$static_entries = 0;
# Should I encode entities for xml content-types? (plugins can turn this off if they do it themselves)
$encode_xml_entities = 1;
%month2num = (
nil => '00',
Jan => '01',
Feb => '02',
Mar => '03',
Apr => '04',
May => '05',
Jun => '06',
Jul => '07',
Aug => '08',
Sep => '09',
Oct => '10',
Nov => '11',
Dec => '12'
);
@num2month = sort { $month2num{$a} <=> $month2num{$b} } keys %month2num;
# Use the stated preferred URL or figure it out automatically. Set
# $url manually in the config section above if CGI.pm doesn't guess
# the base URL correctly, e.g. when called from a Server Side Includes
# document or so.
unless ($url) {
$url = url();
# Support being called from inside a SSI document
$url =~ s/^included:/http:/ if $ENV{SERVER_PROTOCOL} eq 'INCLUDED';
# Remove PATH_INFO if it is set but not removed by CGI.pm. This
# seems to happen when used with Apache's Alias directive or if
# called from inside a Server Side Include document. If that
# doesn't help either, set $url manually in the configuration.
$url =~ s/\Q$ENV{PATH_INFO}\E$// if defined $ENV{PATH_INFO};
# NOTE:
#
# There is one case where this code does more than necessary, too:
# If the URL requested is e.g. http://example.org/blog/blog and
# the base URL is correctly determined as http://example.org/blog
# by CGI.pm, then this code will incorrectly normalize the base
# URL down to http://example.org, because the same string as
# PATH_INFO is part of the base URL, too. But this is such a
# seldom case and can be fixed by setting $url in the config file,
# too.
}
# The only modification done to a manually set base URL is to strip
# a trailing slash if present.
$url =~ s!/$!!;
# Drop ending any / from dir settings
$datadir =~ s!/$!!;
$plugin_dir =~ s!/$!!;
$static_dir =~ s!/$!!;
# Fix depth to take into account datadir's path
$depth += ( $datadir =~ tr[/][] ) - 1 if $depth;
if ( !$ENV{GATEWAY_INTERFACE}
and param('-password')
and $static_password
and param('-password') eq $static_password )
{
$static_or_dynamic = 'static';
}
else {
$static_or_dynamic = 'dynamic';
param( -name => '-quiet', -value => 1 );
}
# Path Info Magic
# Take a gander at HTTP's PATH_INFO for optional blog name, archive yr/mo/day
my @path_info = split m{/}, path_info() || param('path');
$path_info_full = join '/', @path_info; # Equivalent to $ENV{PATH_INFO}
shift @path_info;
# Flavour specified by ?flav={flav} or index.{flav}
$flavour = '';
if (! ($flavour = param('flav'))) {
if ( $path_info[$#path_info] =~ /(.+)\.(.+)$/ ) {
$flavour = $2;
pop @path_info if $1 eq 'index';
}
}
$flavour ||= $default_flavour;
# Fix XSS in flavour name (CVE-2008-2236)
$flavour = blosxom_html_escape($flavour);
sub blosxom_html_escape {
my $string = shift;
my %escape = (
'<' => '<',
'>' => '>',
'&' => '&',
'"' => '"',
"'" => '''
);
my $escape_re = join '|' => keys %escape;
$string =~ s/($escape_re)/$escape{$1}/g;
$string;
}
# Global variable to be used in head/foot.{flavour} templates
$path_info = '';
# Add all @path_info elements to $path_info till we come to one that could be a year
while ( $path_info[0] && $path_info[0] !~ /^(19|20)\d{2}$/) {
$path_info .= '/' . shift @path_info;
}
# Pull date elements out of path
if ($path_info[0] && $path_info[0] =~ /^(19|20)\d{2}$/) {
$path_info_yr = shift @path_info;
if ($path_info[0] &&
($path_info[0] =~ /^(0\d|1[012])$/ ||
exists $month2num{ ucfirst lc $path_info_mo })) {
$path_info_mo = shift @path_info;
# Map path_info_mo to numeric $path_info_mo_num
$path_info_mo_num = $path_info_mo =~ /^\d{2}$/
? $path_info_mo
: $month2num{ ucfirst lc $path_info_mo };
if ($path_info[0] && $path_info[0] =~ /^[0123]\d$/) {
$path_info_da = shift @path_info;
}
}
}
# Add remaining path elements to $path_info
$path_info .= '/' . join('/', @path_info);
# Define standard template subroutine, plugin-overridable at Plugins: Template
$template = sub {
my ( $path, $chunk, $flavour ) = @_;
do {
return join '', <$fh>
if $fh->open("< $datadir/$path/$chunk.$flavour");
} while ( $path =~ s/(\/*[^\/]*)$// and $1 );
# Check for definedness, since flavour can be the empty string
if ( defined $template{$flavour}{$chunk} ) {
return $template{$flavour}{$chunk};
}
elsif ( defined $template{error}{$chunk} ) {
return $template{error}{$chunk};
}
else {
return '';
}
};
# Bring in the templates
%template = ();
while () {
last if /^(__END__)$/;
my ( $ct, $comp, $txt ) = /^(\S+)\s(\S+)(?:\s(.*))?$/ or next;
$txt =~ s/\\n/\n/mg;
$template{$ct}{$comp} .= $txt . "\n";
}
# Plugins: Start
my $path_sep = $^O eq 'MSWin32' ? ';' : ':';
my @plugin_dirs = split /$path_sep/, $plugin_path;
unshift @plugin_dirs, $plugin_dir;
my @plugin_list = ();
my %plugin_hash = ();
# If $plugin_list is set, read plugins to use from that file
if ( $plugin_list ) {
if ( -r $plugin_list and $fh->open("< $plugin_list") ) {
@plugin_list = map { chomp $_; $_ } grep { /\S/ && !/^#/ } <$fh>;
$fh->close;
}
else {
warn "unable to read or open plugin_list '$plugin_list': $!";
$plugin_list = '';
}
}
# Otherwise walk @plugin_dirs to get list of plugins to use
if ( ! @plugin_list && @plugin_dirs ) {
for my $plugin_dir (@plugin_dirs) {
next unless -d $plugin_dir;
if ( opendir PLUGINS, $plugin_dir ) {
for my $plugin (
grep { /^[\w:]+$/ && !/~$/ && -f "$plugin_dir/$_" }
readdir(PLUGINS) )
{
# Ignore duplicates
next if $plugin_hash{$plugin};
# Load all plugins in @plugin_list
unshift @INC, @plugin_dirs;
foreach my $plugin (@plugin_list) {
my ( $plugin_name, $off ) = $plugin =~ /^\d*([\w:]+?)(_?)$/;
my $plugin_file = $plugin_list ? $plugin_name : $plugin;
my $on_off = $off eq '_' ? -1 : 1;
# Allow perl module plugins
# The -z test is a hack to allow a zero-length placeholder file in a
# $plugin_path directory to indicate an @INC module should be loaded
if ( $plugin =~ m/::/ && ( $plugin_list || -z $plugin_hash{$plugin} ) ) {
# For Blosxom::Plugin::Foo style plugins, we need to use a string require
eval "require $plugin_file";
}
else
{ # we try first to load from $plugin_dir before attempting from $plugin_path
eval { require "$plugin_dir/$plugin_file" }
or eval { require $plugin_file };
}
if ($@) {
warn "error finding or loading blosxom plugin '$plugin_name': $@";
next;
}
if ( $plugin_name->start() and ( $plugins{$plugin_name} = $on_off ) ) {
push @plugins, $plugin_name;
}
}
shift @INC foreach @plugin_dirs;
# Plugins: Template
# Allow for the first encountered plugin::template subroutine to override the
# default built-in template subroutine
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('template') ) {
if ( my $tmp = $plugin->template() ) {
$template = $tmp;
last;
}
}
}
# Provide backward compatibility for Blosxom < 2.0rc1 plug-ins
sub load_template {
return &$template(@_);
}
# Define default entries subroutine
$entries = sub {
my ( %files, %indexes, %others );
find(
sub {
my $d;
my $curr_depth = $File::Find::dir =~ tr[/][];
return if $depth and $curr_depth > $depth;
if (
# a match
$File::Find::name
=~ m!^$datadir/(?:(.*)/)?(.+)\.$file_extension$!
# not an index, .file, and is readable
and $2 ne 'index' and $2 !~ /^\./ and ( -r $File::Find::name )
)
{
# read modification time
my $mtime = stat($File::Find::name)->mtime or return;
# to show or not to show future entries
return unless ( $show_future_entries or $mtime < time );
# add the file and its associated mtime to the list of files
$files{$File::Find::name} = $mtime;
# not an entries match
elsif ( !-d $File::Find::name and -r $File::Find::name ) {
$others{$File::Find::name} = stat($File::Find::name)->mtime;
}
},
$datadir
);
return ( \%files, \%indexes, \%others );
};
# Plugins: Entries
# Allow for the first encountered plugin::entries subroutine to override the
# default built-in entries subroutine
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('entries') ) {
if ( my $tmp = $plugin->entries() ) {
$entries = $tmp;
last;
}
}
}
# Plugins: Filter
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('filter') ) {
$entries = $plugin->filter( \%files, \%others );
}
}
my %f = %files;
# Plugins: Skip
# Allow plugins to decide if we can cut short story generation
my $skip;
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('skip') ) {
if ( my $tmp = $plugin->skip() ) {
$skip = $tmp;
last;
}
}
}
# Plugins: Interpolate
# Allow for the first encountered plugin::interpolate subroutine to
# override the default built-in interpolate subroutine
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('interpolate') ) {
if ( my $tmp = $plugin->interpolate() ) {
$interpolate = $tmp;
last;
}
}
}
# Head
my $head = ( &$template( $currentdir, 'head', $flavour ) );
# Plugins: Head
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('head') ) {
$entries = $plugin->head( $currentdir, \$head );
}
}
$head = &$interpolate($head);
$output .= $head;
# Stories
my $curdate = '';
my $ne = $num_entries;
if ( $currentdir =~ /(.*?)([^\/]+)\.(.+)$/ and $2 ne 'index' ) {
$currentdir = "$1$2.$file_extension";
%f = ( "$datadir/$currentdir" => $files{"$datadir/$currentdir"} )
if $files{"$datadir/$currentdir"};
}
else {
$currentdir =~ s!/index\..+$!!;
}
# Define a default sort subroutine
my $sort = sub {
my ($files_ref) = @_;
return
sort { $files_ref->{$b} <=> $files_ref->{$a} }
keys %$files_ref;
};
# Plugins: Sort
# Allow for the first encountered plugin::sort subroutine to override the
# default built-in sort subroutine
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('sort') ) {
if ( my $tmp = $plugin->sort() ) {
$sort = $tmp;
last;
}
}
}
foreach my $path_file ( &$sort( \%f, \%others ) ) {
last if $ne <= 0 && $date !~ /\d/;
use vars qw/ $path $fn /;
( $path, $fn )
= $path_file =~ m!^$datadir/(?:(.*)/)?(.*)\.$file_extension!;
# Only stories in the right hierarchy
$path =~ /^$currentdir/
or $path_file eq "$datadir/$currentdir"
or next;
# Prepend a slash for use in templates only if a path exists
$path &&= "/$path";
# Only stories from the right date
my ( $path_info_yr, $path_info_mo_num, $path_info_da )
= split /\//, $date;
next if $path_info_yr && $yr != $path_info_yr;
last if $path_info_yr && $yr < $path_info_yr;
next if $path_info_mo_num && $mo ne $num2month[$path_info_mo_num];
next if $path_info_da && $da != $path_info_da;
last if $path_info_da && $da < $path_info_da;
# Date
my $date = ( &$template( $path, 'date', $flavour ) );
# Plugins: Date
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('date') ) {
$entries
= $plugin->date( $currentdir, \$date,
$files{$path_file}, $dw, $mo, $mo_num, $da, $ti,
$yr );
}
}
$date = &$interpolate($date);
if ( $date && $curdate ne $date ) {
$curdate = $date;
$output .= $date;
}
# Plugins: Story
foreach my $plugin (@plugins) {
if ( $plugins{$plugin} > 0 and $plugin->can('story') ) {
$entries = $plugin->story( $path, $fn, \$story, \$title,
\$body );
}
}
if ( $encode_xml_entities &&
$content_type =~ m{\bxml\b} &&
$content_type !~ m{\bxhtml\b} ) {
# Escape special characters inside the container
# The following line should be moved more towards to top for
# performance reasons -- Axel Beckert, 2008-07-22
my $url_escape_re = qr([^-/a-zA-Z0-9:._]);
rss head
rss head rss head rss head $blog_title rss head $url/$path_info
rss head $blog_description rss head $blog_language rss head http://blogs.law.harvard.edu/tech/rss rss head blosxom/$version
rss story rss story $title rss story $dw, $da $mo $yr $ti:00 $utc_offset rss story $url/$yr/$mo_num/$da#$fn
rss story $path rss story $url$path/$fn rss story $body rss story
rss date
rss foot rss foot
error content_type text/html
error head
error head
error head Error: unknown Blosxom flavour "$flavour" error head
error head
Error: unknown Blosxom flavour "$flavour"
error head
I'm afraid this is the first I've heard of a "$flavour" flavoured Blosxom. Try dropping the "/+$flavour" bit from the end of the URL.