aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorStefan Ritter <xeno@thehappy.de>2011-07-13 13:38:28 +0200
committerStefan Ritter <xeno@thehappy.de>2011-07-13 13:38:28 +0200
commit7bf8b5659f900e1546672c016353d5c09df6c5e4 (patch)
tree1a28e3428dd46e2d8b04978b294a6be147655365
parent8f686736fe9aee8db55e183fd72c5ff87ea5f5a3 (diff)
Update README
* using asciidoc * add pdf
Diffstat (limited to '')
-rw-r--r--README110
-rw-r--r--README.pdfbin0 -> 59897 bytes
-rw-r--r--README.txt103
3 files changed, 103 insertions, 110 deletions
diff --git a/README b/README
deleted file mode 100644
index 2959c6b..0000000
--- a/README
+++ /dev/null
@@ -1,110 +0,0 @@
-Index:
-
- 1) Installation
- 1.1) Apache
- 1.2) Lighttpd
- 2) Entries
- 3) Staticpages
- 4) Comments
- 5) Linklist
-
-
-1) Installation
-===============
-The installation of Blogthon assumes that your httpd 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 3 files into your www directory:
-
- * blogthon.cgi
- * styles
- * .htaccess (optional, but security relevant)
-
-Then create 3 directories and 1 empty file:
-
- * entries/
- * static/
- * plugins/
- * linklist
-
-If you don't want to disable comments, you have to change the permissions of
-entries/ to 777.
-
-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.
-
-
-1.1) Apache
-===========
-To enable CGI you just have to run 'a2enmod cgi' as root. Now put something
-like this in /etc/apache2/sites-available/default:
-
-<Directory /this/is/where/your/www/root/is/>
- Options +ExecCGI
- AddHandler cgi-script .cgi
- DirectoryIndex blogthon.cgi
-</Directory>
-
-To finish the installation, reload Apache with
-'/etc/init.d/apache2 force-reload' as root.
-
-
-1.2) Lighttpd
-=============
-First you have to enable cgi support for lighttp 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:
-
-$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.
-
-
-2) Entries
-==========
-To start blogging you just have to open your favorite editor, write your entry
-and save it under entries/. The filename should be like this:
- (entry title).(suffix)
-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.
-
-
-3) 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'.
-
-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:
-extern_link: http://your/link.
-
-
-4) 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
-
-
-5) Linklist
-===========
-To add a link to your linklist, just add a line to the linklist file:
-
-http://some/link name of your link
-
-Of course you can use empty lines to split different sorts of links.
diff --git a/README.pdf b/README.pdf
new file mode 100644
index 0000000..af450fa
--- /dev/null
+++ b/README.pdf
Binary files differ
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..d158663
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,103 @@
+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.