NAME
blosxom - A lightweight yet feature-packed weblog
SYNOPSIS
blosxom is a simple web log (blog) CGI script written in perl.
DESCRIPTION
Blosxom (pronounced "blossom") 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.
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 first.txt 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 <a
href="http://www.blosxom.com/">blosxom site</a>.
Place the file in the directory under the $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. On Debian systems, this
location default to /var/lib/blosxom/data.
OPTIONS
Configuration of the blosxom can be controlled via the configuration
file /etc/blosxom/blosxom.conf. Some of the possible configuration
variables are:
$blog_title
Title of this blog. (default: "Blosxom")
$blog_description
Description of the blog used for RSS generation. (default "Yet
another Blosxom blog")
$blog_language
This blog’s primary language used for outgoing RSS feed.
(default "en")
$datadir
Where are this blog’s entries kept? (default on Debian:
"/var/lib/blosxom/data")
$url Preferred base URL for this blog (leave blank for automatic)
(default: "")
$file_extension
Preferred ending of blog entry files (default: "txt"). Other
files are ignored.
$default_flavour
Blog style can be controlled via templates, or flavours.
(default: "html").
FILES
/usr/lib/cgi-bin/blosxom the CGI script
/etc/blosxom/blosxom.conf the configuration on Debian systems
AUTHOR
Rael Dornfest is the author of blosxom <rael@oreilly.com> See
http://www.blosxom.com and http://www.raelity.org for more information.
This manual page was written by Marc Nozell <marc@nozell.com> and Dirk
Eddelbuettel <edd@debian.org> for the Debian GNU/Linux distribution but
may be used by others.