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.