cblog.cgi(13 January 2010) cblog.cgi(13 January 2010)
NAME
cblog.cgi - fastcgi interface for cblog
DESCRIPTION
cblog.cgi is the fastcgi interface to cblog. It uses the clearsilver
template system to render html pages
VARIABLES
TEMPLATE
The following variables are available in the template :
· Posts.N.title: title of a post
· Posts.N.date: date of a post in the wanted format
· Posts.N.tags.N.name: name of each defined tags in a post
· Posts.N.source : the post in markdown format
· Posts.N.html: the post rendered in XHTML
· Tags.N.name: tag name
· Tags.N.count: number of posts concerned by the tag
· CBlog.version: version number of cblog
· CBlog.www: default cblog website
You can add as much variable as you want in the template by adding them
to your configuration file.
CONFIGURATION
The configuration file is read from /usr/local/etc/cblog.conf
The following option are nedded :
· hdf.loadpaths.tpl: this is the place where the templates file should
be found
· cgiout.charset: set here the output charset you want to use (ie
utf-8)
· db.dir: patch where the cblog database should be found must be read‐
able for the user that own the fastcgi process
· theme: name of the template to use (default: default.cs)
· post_per_pages: number of post to show per pages (for the website or
the feeds) (default: 10)
· feed.rss: name of the template to use to render rss feed (default:
rss.cs)
· feed.atom: name of the template to use to render atom feed (default:
atom.cs)
· dateformat: the date format for the post (in webview)
Everything you will add that is not listed here will be available in
your templates
SEE_ALSO cdb(1)cblogctl(1)BUGS
On NetBSD clearsilver has a bug rendering some utf8 characters a work‐
around is to add Config.WhiteSpaceStrip=0 to your configuration file
AUTHORS
Baptiste Daroussin <bapt@etoilebsd.net>
cblog.cgi(13 January 2010)