Zammad admin documentation
If you want to contribute to zammad documentation you can edit the *.rst files and create pull requests.
We take care about the translation part, so please don't change anything else whithin the repo, those changes will be discarded anyway ;) .
Note: At the moment we only have a german translation. We are working on an english version and will change the default later.
Zammad hosts a searchable version of this documentation on https://docs.zammad.org
If you like to edit the docs use the ReStructuredText markup language. Infos about this markup language can be found at:
Local tests (mostly internal stuff)
If you want to test the doc for yourself you need a local installation of sphinx and gettext.
pip install sphinx sphinx-autobuild sphinx-intl sphinx_rtd_theme
Example for a local HTML build
Example workflow for localization using transifex
If you have to work on the translations you need gettext.
For OS X use HomeBrew or build from source. For Linux use your package manager.
brew install gettext
The workflow itself
# create .tx config tx init # or when just want to update a ressource tx set --source -r <project_slug.resource_slug> -l <lang> <file> make clean # this will generate the strings from the *.rst files make gettext # this will generate the locales (DE|EN) sphinx-intl update -p _build/locale/ -l de -l en # this will update the ressource files from the pot dir sphinx-intl update-txconfig-resources --pot-dir _build/locale --transifex-project-name zammad-admin-documentation # push to transifex (if configured) tx push -s # after translation pull needed languages from transifex tx pull -l en # manual build based upon the language (_build/html/) make -e SPHINXOPTS="-D language='de'" html make -e SPHINXOPTS="-D language='en'" html
If you have a problem, please create an issue. Thanks.