|blosxom :: the zen of blogging|
StaticBlosxom runs either dynamically (on-the-fly) as a CGI script--the default--or on the command-line for statically rendering the main index, category indexes, and date indexes as regular files on your filesystem. Static rendering is useful for those who either prefer to or are only able to (they can't run CGI scripts) serve up files from their Web server. You can render your blog from the command-line on the server or locally--on your laptop, say--and save them to a mounted WebDAV drive, .Mac iDisk, or FTP/rsync them up to your server. You can also take a hybrid approach, statically rendering all of your regular Weblog while leaving room for experimentation with search, trackbacks, home-brewed bits of functionality, plugins, and so forth.
Configure static rendering...Blosxom's default is dynamic rendering (i.e. running as a CGI script). To enable static rendering, you'll need to create a directory to hold your static Web pages and configure Blosxom for static rendering.
Render your blog...Static rendering is designed to run only from the command-line. It looks for the absence of the standard
To run Blosxom static rendering, on the command-line type:
perl blosxom.cgi -password='whateveryourpassword'(Where
% perl blosxom.cgi -password='whateveryourpassword' Blosxom is generating static index pages... /index.html /index.rss 2002/index.html 2002/index.rss 2002/06/index.html 2002/06/index.rss 2002/06/29/index.html 2002/06/29/index.rss ... society/index.html society/index.rss society/film/index.html society/film/index.rss %(Your paths will, of course, differ.) Run it again and Blosxom shouldn't render anything since it's smart enough to know that nothing's changed (nothing new's been blogged) since the last run.
% perl blosxom.cgi -password='whateveryourpassword' Blosxom is generating static index pages... %To force Blosxom to regenerate alll pages, add another command-line switch,
% perl blosxom.cgi -password='whateveryourpassword' -all=1Blosxom should once again render all pages, regardless of how recently they've changed. To have Blosxom's static rendering run silently -- perhaps you're running it automatically at regular intervals and you don't want all that output popping up on your screen or being mailed to you--add
% perl blosxom.cgi -password='whateveryourpassword' -quiet=1
automatic rendering at regular intervals...While you can of course run Blosxom by hand from the command-line every time you write something new to your blog, most of you will probably want to have Blosxom make a static rendering pass on a regular basis, automatically. If you're running a Unix variant or Mac OS X, the best tool for the job is
0,30 * * * * /usr/bin/perl /path/to/blosxom.cgi -password='whateveryourpassword' -quiet=1
(The line above has been split into two for display purposes; be sure to put everything on one line in your crontab.)
For those of you running operating systems without