systemausfall.org/tycker
5
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Migrate to markdown

Browse source
This commit is contained in:
phil 2021-02-14 22:41:20 +01:00
parent e2eadd8f8b
commit a328fafac5
1 changed files with 26 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
README.txt → README.md
View file

@ -1,76 +1,74 @@
= tycker - a web-based ticker input form = # tycker - a web-based ticker input form
== Overview == ## 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](http://www.wikicreole.org/imageServlet?page=CheatSheet%2Fcreole_cheat_sheet.png)
http://www.wikicreole.org/imageServlet?page=CheatSheet%2Fcreole_cheat_sheet.png
The data items are stored in an sqlite database by default. Other options The data items are stored in an sqlite database by default. Other options
(mysql/postgres) are easily configurable, as well. (mysql/postgres) are easily configurable, as well.
The result is processed via the template "display.html". Adjust this file to 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 == ## Installation
Debian-based systems: Debian-based systems:
* apt-get install python-bobo python-genshi python-sqlobject
apt-get install python-bobo python-genshi python-sqlobject
Additionally you need a wsgi-capable webserver. The most popular solution Additionally you need a wsgi-capable webserver. The most popular solution
would be the following: would be the following:
* apt-get install libapache2-mod-wsgi
apt-get install libapache2-mod-wsgi
Get the sources and extract them within the tree of your webserver: Get the sources and extract them within the tree of your webserver:
* svn co https://svn.systemausfall.org/svn/codekasten/tycker /var/www/tycker svn co https://svn.systemausfall.org/svn/codekasten/tycker /var/www/tycker
Maybe you will need to enable "AllowOverride FileInfo Options" for this Maybe you will need to enable "AllowOverride FileInfo Options" for this
directory. Take a look at .htaccess for details. directory. Take a look at .htaccess for details.
Alternatively you can also use "WSGIScriptAlias" directive Alternatively you can also use [WSGIScriptAlias directive](http://code.google.com/p/modwsgi/wiki/ConfigurationDirectives) for a
(http://code.google.com/p/modwsgi/wiki/ConfigurationDirectives) for a
cleaner URL. cleaner URL.
== Configuration == ## Configuration
Configuration is currently done via five settings: Configuration is currently done via five settings:
* DATE_FORMAT = "%H:%M %d.%m.%Y" * DATE_FORMAT = "%H:%M %d.%m.%Y"
** how the date is represented (and parsed) in the input field * how the date is represented (and parsed) in the input field
* PAGE_SIZE = 10 * PAGE_SIZE = 10
** how many ticker entries should be displayed per html output file * how many ticker entries should be displayed per html output file
* FILENAME_TEMPLATE = "ticker%d.html" * FILENAME_TEMPLATE = "ticker%d.html"
** basename of the resulting html files * basename of the resulting html files
* FULL_PATH_FILENAME_TEMPLATE = os.path.join(BASE_DIR, os.path.pardir, FILENAME_TEMPLATE) * 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 * absolute path of the result html file (by default: in the parent directory of tycker's base directory)
of tycker's base directory)
Probably you will want to configure some http-authentifaction to protect your Probably you will want to configure some http-authentifaction to protect your tycker directory from unintended access.
tycker directory from unintended access.
The static output generated by tycker can be styled by placing css and other files alongside. The static output generated by tycker can be styled by placing css and other files alongside. You may want to use the content of 'example-output-style' as a usable starting point.
You may want to use the content of 'example-output-style' as a usable starting point.
== Usage == ## Usage
Point your webbrowser to the installation directory: Point your webbrowser to the installation directory:
* http://localhost/tycker/tycker.py/
http://localhost/tycker/tycker.py/
The result is available (by default) at: The result is available (by default) at:
* http://localhost/ticker1.html
http://localhost/ticker1.html
== Bug reports / feedback == ## Bug reports / feedback
Just send a mail to devel@sumpralle.de. Just send a mail to devel@sumpralle.de.
== License == ## License
tycker is published under the AGPL v3.0 (or later) license. tycker is published under the AGPL v3.0 (or later) license.
http://www.gnu.org/licenses/agpl-3.0.html http://www.gnu.org/licenses/agpl-3.0.html