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  accessible  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.

Blosxom                                         February 5, 2003                                      BLOSXOM(7)