Contributing to Kolab documentation via github/sphinx November 13th, 2013
The new Kolab 3.1 documentation is written in reStructuredText, using a tool called Sqhinx which was originally created for the Python documentation.
It is much easier to edit than the Publican notation used before for the Kolab 3.0 documentation.
The website for Sqhinx is here: http://sphinx-doc.org/
Some useful links for getting started with writing documentation with Sqhinx:
You find the sources of the Kolab Documentation here: https://github.com/kolab-groupware/kolab-docs
You can fork that repository, make your own changes, even online at github.
For more complex jobs, I recommend cloning your github fork locally, and work there, and commit and push when you are happy.
See also a good tutorial at Github for this: https://help.github.com/articles/fork-a-repo
It also makes sense to build the documentation locally, and have a look at your changes.
On CentOS, you need to do this:
yum install python-setuptools make easy_install -U Sphinx wget http://www.graphviz.org/graphviz-rhel.repo -O /etc/yum.repos.d/graphviz-rhel.repo yum install graphviz-python graphviz-gd git clone https://<your github username>@github.com/<your github username>/kolab-docs.git cd kolab-docs make html
You will find the result in the directory build/html
SQL2Diagram November 18th, 2007
SQL2Diagram: A sourceforge project that I am involved in; we use that program at work to keep track of our database structure, consisting of 250+ tables in several modules.
It basically parses the SQL Create Table statements and generates both HTML documentation and diagrams in XML format that can be displayed with the program Dia.