X-Git-Url: https://git.deb.at/?p=pkg%2Fblosxom.git;a=blobdiff_plain;f=blosxom.cgi;h=d2c1c46b76d223381e9be3f48fd771656985f781;hp=712b8e2bd4795984e9cb90d8af85a6c1530478d2;hb=10beab43faade09fc0728590ff8c4ee81cd63994;hpb=aacc432f8e6ad1c19d9f689b64cc72858155f7c8 diff --git a/blosxom.cgi b/blosxom.cgi index 712b8e2..d2c1c46 100755 --- a/blosxom.cgi +++ b/blosxom.cgi @@ -2,12 +2,62 @@ # Blosxom # Author: Rael Dornfest (2002-2003), The Blosxom Development Team (2005-2008) -# Version: 2.1.2 ($Id: blosxom.cgi,v 1.85 2008/10/02 01:09:41 xtaran Exp $) +# Version: 2.1.2 ($Id: blosxom.cgi,v 1.91 2009/03/08 00:58:52 xtaran Exp $) # Home/Docs/Licensing: http://blosxom.sourceforge.net/ # Development/Downloads: http://sourceforge.net/projects/blosxom package blosxom; +=head1 NAME + +blosxom - A lightweight yet feature-packed weblog + +=head1 SYNOPSIS + +B is a simple web log (blog) CGI script written in perl. + +=head1 DESCRIPTION + +B (pronounced "I") is a lightweight yet feature-packed +weblog application designed from the ground up with simplicity, +usability, and interoperability in mind. + +Fundamental is its reliance upon the file system, folders and files +as its content database. Blosxom's weblog entries are plain text +files like any other. Write from the comfort of your favorite text +editor and hit the Save button. Create, edit, rename, and delete entries +on the command-line, via FTP, WebDAV, or anything else you +might use to manipulate your files. There's no import or export; entries +are nothing more complex than title on the first line, body being +everything thereafter. + +Despite its tiny footprint, Blosxom doesn't skimp on features, sporting +the majority of features one would find in any other Weblog application. + +Blosxom is simple, straightforward, minimalist Perl affording even the +dabbler an opportunity for experimentation and customization. And +last, but not least, Blosxom is open source and free for the taking and +altering. + +=head1 USAGE + +Write a weblog entry, and place it into the main data directory. Place +the the title is on the first line; the body is everything afterwards. +For example, create a file named I and put in it something +like this: + + First Blosxom Post! + + I have successfully installed blosxom on this system. For more + information on blosxom, see the author's blosxom site. + +Place the file in the directory under the I<$datadir> points to. Be +sure to change the default location to be somewhere accessable by the +web server that runs blosxom as a CGI program. + +=cut + # --- Configurable variables ----- # What's this blog's title? @@ -25,12 +75,16 @@ $blog_encoding = "UTF-8"; # Where are this blog's entries kept? $datadir = "/Library/WebServer/Documents/blosxom"; -# What's my preferred base URL for this blog (leave blank for automatic)? +# 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 +# +# 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? @@ -47,8 +101,8 @@ $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) +# 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? @@ -57,8 +111,8 @@ $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 +# Additional plugins location. A list of directories, separated by ';' +# on windows, ':' everywhere else. $plugin_path = ""; # --- Static Rendering ----- @@ -66,7 +120,8 @@ $plugin_path = ""; # 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)? +# What's my administrative password (you must set this for static +# rendering)? $static_password = ""; # What flavours should I generate statically? @@ -76,11 +131,61 @@ $static_password = ""; # 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) +# --- Advanced Encoding Options ----- + +# Should I encode entities for xml content-types? (plugins can turn +# this off if they do it themselves) $encode_xml_entities = 1; # -------------------------------- +=head1 ENVIRONMENT + +=over + +=item B + +Points to the location of the configuration file. This will be +considered as first option, if it's set. + + +=item B + +The here named directory will be tried unless the above mentioned +environment variable is set and tested for a contained blosxom.conf +file. + + +=back + + +=head1 FILES + +=over + +=item B + +The CGI script itself. Please note that the location might depend on +your installation. + +=item B + +The default configuration file location. This is rather taken as last +ressort if no other configuration location is set through environment +variables. + +=back + + +=head1 AUTHOR + +Rael Dornfest was the original author of blosxom. The +development was picked up by a team of dedicated users of blosxom since +2005. See > for more information. + +=cut + + use vars qw! $version $blog_title $blog_description $blog_language $blog_encoding $datadir $url %template $template $depth $num_entries $file_extension $default_flavour $static_or_dynamic $config_dir $plugin_list $plugin_path $plugin_dir $plugin_state_dir @plugins %plugins $static_dir $static_password @static_flavours $static_entries $path_info_full $path_info $path_info_yr $path_info_mo $path_info_da $path_info_mo_num $flavour $static_or_dynamic %month2num @num2month $interpolate $entries $output $header $show_future_entries %files %indexes %others $encode_xml_entities $content_type !; @@ -91,7 +196,7 @@ use File::stat; use Time::Local; use CGI qw/:standard :netscape/; -$version = "2.1.2"; +$version = "2.1.2+dev"; # Load configuration from $ENV{BLOSXOM_CONFIG_DIR}/blosxom.conf, if it exists my $blosxom_config; @@ -710,19 +815,11 @@ sub generate { $fn =~ s($url_escape_re)(sprintf('%%%02X', ord($&)))eg; # Escape <, >, and &, and to produce valid RSS - my %escape = ( - '<' => '<', - '>' => '>', - '&' => '&', - '"' => '"', - "'" => ''' - ); - my $escape_re = join '|' => keys %escape; - $title =~ s/($escape_re)/$escape{$1}/g; - $body =~ s/($escape_re)/$escape{$1}/g; - $url =~ s/($escape_re)/$escape{$1}/g; - $path =~ s/($escape_re)/$escape{$1}/g; - $fn =~ s/($escape_re)/$escape{$1}/g; + $title = blosxom_html_escape($title); + $body = blosxom_html_escape($body); + $url = blosxom_html_escape($url); + $path = blosxom_html_escape($path); + $fn = blosxom_html_escape($fn); } $story = &$interpolate($story);