BLOSXOM(7)								 7								BLOSXOM(7)

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, usabil-
       ity, 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  noth-
       ing 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 appli-
       cation.

       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 after-
       wards.  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.

Blosxom 							 February 5, 2003							BLOSXOM(7)