Uralte Blogsoftware, die ich 2009 in Python geschrieben habe. Nicht mehr zur produktiven Nutzung geeignet! ;-)
25e7cc7a09
* Parts of new comment mail now in blog_locale[] |
||
---|---|---|
entries | ||
plugins | ||
static | ||
styles/default | ||
.gitignore | ||
.htaccess | ||
blogthon.cgi | ||
configuration | ||
error.css | ||
linklist | ||
README.pdf | ||
README.txt |
Blogthon ======== Stefan Ritter <xeno@thehappy.de> :Date: 2011-07-13 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 * styles * .htaccess (Apache) * error.css 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] <Directory "/path/to/your/webroot/"> AllowOverride all </Directory> 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 <br /> behind each line, except for lines with <ul>, <li>, <table>, etc... So you don't need to make your own layout using <br /> tags. Aside from that you can certainly use <p> elements and all other HTML tags. Staticpages ~~~~~~~~~~~ Staticpages are placed under static/ without a suffix. To sort them, you can start the filename with a literal and -. So "01-Foo" will be placed before "02-Bar": [source,sh] vim static/02-Bar If you want to make a staticpage to be a link to an extern page, you just have to place the following content in the first line: [source,sh] extern_link: http://your/link Comments ~~~~~~~~ Comments are saved under entries/ like all entries, but with the suffix ".comments". The syntax in this file is like this: -.Nickname +.Date .some text .more text Linklist ~~~~~~~~ To add a link to your linklist, just add a line to the linklist file: [source,sh] http://some/link Name of your link Of course you can use empty lines to split different sorts of links.