blosxom(7) [debian man page]
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)
Check Out this Related Man Page
BLAZE-ADD(1) BlazeBlogger Documentation BLAZE-ADD(1) NAME
blaze-add - adds a blog post or a page to the BlazeBlogger repository SYNOPSIS
blaze-add [-pqCPV] [-b directory] [-E editor] [-a author] [-d date] [-t title] [-k keywords] [-T tags] [-u url] [file...] blaze-add -h|-v DESCRIPTION
blaze-add adds a blog post or a page to the BlazeBlogger repository. If a file is supplied, it adds the content of that file, otherwise an external text editor is opened for you. Note that there are several special forms and placeholders that can be used in the text, and that will be replaced with a proper data when the blog is generated. Special Forms <!-- break --> A mark to delimit a blog post synopsis. Placeholders %root% A relative path to the root directory of the blog. %home% A relative path to the index page of the blog. %page[id]% A relative path to a page with the supplied id. %post[id]% A relative path to a blog post with the supplied id. %tag[name]% A relative path to a tag with the supplied name. OPTIONS
-b directory, --blogdir directory Allows you to specify a directory in which the BlazeBlogger repository is placed. The default option is a current working directory. -E editor, --editor editor Allows you to specify an external text editor. When supplied, this option overrides the relevant configuration option. -t title, --title title Allows you to specify the title of a blog post or page. -a author, --author author Allows you to specify the author of a blog post or page. -d date, --date date Allows you to specify the date of publishing of a blog post or page. -k keywords, --keywords keywords Allows you to specify a comma-separated list of keywords attached to a blog post or page. -T tags, --tags tags Allows you to supply a comma-separated list of tags attached to a blog post. -u url, --url url Allows you to specify the url of a blog post or page. Allowed characters are letters, numbers, hyphens, and underscores. -p, --page, --pages Tells blaze-add to add a page or pages. -P, --post, --posts Tells blaze-add to add a blog post or blog posts. This is the default option. -C, --no-processor Disables processing a blog post or page with an external application. For example, if you use Markdown to convert the lightweight markup language to the valid HTML output, this will enable you to write this particular post in plain HTML directly. -q, --quiet Disables displaying of unnecessary messages. -V, --verbose Enables displaying of all messages. This is the default option. -h, --help Displays usage information and exits. -v, --version Displays version information and exits. ENVIRONMENT
EDITOR Unless the core.editor option is set, BlazeBlogger tries to use system-wide settings to decide which editor to use. EXAMPLE USAGE
Write a new blog post in an external text editor: ~]$ blaze-add Add a new blog post from a file: ~]$ blaze-add new_packages.txt Successfully added the post with ID 10. Write a new page in an external text editor: ~]$ blaze-add -p Write a new page in nano: ~]$ blaze-add -p -E nano SEE ALSO
blaze-init(1), blaze-config(1), blaze-edit(1), blaze-remove(1), blaze-make(1) BUGS
To report a bug or to send a patch, please, add a new issue to the bug tracker at <http://code.google.com/p/blazeblogger/issues/>, or visit the discussion group at <http://groups.google.com/group/blazeblogger/>. COPYRIGHT
Copyright (C) 2008-2011 Jaromir Hradilek This program is free software; see the source for copying conditions. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Version 1.2.0 2012-03-05 BLAZE-ADD(1)