README completed

This commit is contained in:
lars 2012-04-20 11:51:09 +00:00
parent 67798982cb
commit 2d989db66d

View file

@ -1,5 +1,8 @@
= tycker - a web-based ticker input form =
== Overview ==
tycker offers a very simple interface to be used for entering ticker information.
Each entry consists of the current time, a title and content.
The content may be written in wikicreole syntax:
@ -12,3 +15,52 @@ The result is processed via the template "display.html". Adjust this file to
generate the desired layout.
Generated html files are stored in the parent directory of tycker's base directory.
== Installation ==
Debian-based systems:
* apt-get install python-bobo python-genshi python-sqlobject
Additionally you need a wsgi-capable webserver. The most popular solution
would be the following:
* apt-get install libapache2-mod-wsgi
Get the sources and extract them within the tree of your webserver:
* svn co https://svn.systemausfall.org/svn/codekasten/tycker /var/www/tycker
Maybe you will need to enable "AllowOverride FileInfo Options" for this
directory. Take a look at .htaccess for details.
Alternatively you can also use "WSGIScriptAlias" directive
(http://code.google.com/p/modwsgi/wiki/ConfigurationDirectives) for a
cleaner URL.
== Configuration ==
Configuration is currently done via five settings:
* DATE_FORMAT = "%H:%M %d.%m.%Y"
** how the date is represented (and parsed) in the input field
* PAGE_SIZE = 10
** how many ticker entries should be displayed per html output file
* FILENAME_TEMPLATE = "ticker%d.html"
** basename of the resulting html files
* FULL_PATH_FILENAME_TEMPLATE = os.path.join(BASE_DIR, os.path.pardir, FILENAME_TEMPLATE)
** absolute path of the result html file (by default: in the parent directory
of tycker's base directory)
Probably you will want to configure some http-authentifaction to protect your
tycker directory from unintended access.
== Usage ==
Point your webbrowser to the installation directory:
* http://localhost/tycker/tycker.py/
The result is available (by default) at:
* http://localhost/ticker1.html
== Bug reports / feedback ==
Just send a mail to devel@sumpralle.de.