README completed

This commit is contained in:
lars 2012-04-20 11:51:09 +00:00
parent 5ff3847d8f
commit f5566f18fd

View file

@ -1,5 +1,8 @@
= tycker - a web-based ticker input form = = tycker - a web-based ticker input form =
== Overview ==
tycker offers a very simple interface to be used for entering ticker information. tycker offers a very simple interface to be used for entering ticker information.
Each entry consists of the current time, a title and content. Each entry consists of the current time, a title and content.
The content may be written in wikicreole syntax: 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. generate the desired layout.
Generated html files are stored in the parent directory of tycker's base directory. 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.