Blogthon ======== Stefan Ritter :Date: 2012-01-21 Installation ------------ The installation of Blogthon assumes that your webserver supports CGI and Python is installed. If all this is given, you can download Blogthon in a directory of your choice. After that you have to symlink the following files/directories into your webroot: * blogthon.cgi * .htaccess (Apache) * error.css * styles Then create 3 directories and 1 empty file: * entries/ * static/ * plugins/ * linklist Your webserver needs write access to the entries directory: [source,sh] $ chmod 777 entries Now copy the example configuration into your www directory, or to ../blogthonrc or ../.blogthonrc. If all this is done, you can continue with setting up your httpd. Apache ~~~~~~ To enable CGI you just have to run "a2enmod cgi" as root. In some cases you have to allow .htaccess for Apache: [source,sh] AllowOverride all To finish the installation, reload Apache with "/etc/init.d/apache2 force-reload" as root. Lighttpd ~~~~~~~~ First you have to enable cgi support for lighttpd by running "lighty-enable-mod cgi" as root. Now create a new config in /etc/lighttpd/conf-available/ named 50-blogthon.conf or something similar with this content: [source,sh] $HTTP["host"] == "YourBlogURL" { cgi.assign = ( ".cgi" => "/usr/bin/python" ) index-file.names = ( "blogthon.cgi" ) } Enable this config by runnung "lighty-enable-mod blogthon" and restart lighttpd with "/etc/init.d/lighttpd restart" as root. Using Blogthon -------------- To start blogging you just have to open your favorite editor, write your entry and save it under entries/: [source,sh] vim entries/Title.txt The suffix can be set in your configuration file. Default is ".txt". While parsing an entry, blogthon places a
behind each line, except for lines with