Admin docs for Zammad
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_static/theme
images
integrations Fixed Hint-Error (Typo) Dec 6, 2018
locale
.DS_Store
.gitignore
Makefile
Readme.md
Roles
Tipps
channels-chat.rst
channels-email.rst
channels-facebook.rst
channels-form.rst
channels-telegram.rst
channels-twitter.rst
channels-web.rst
conf.py
index.rst
manage-calendars.rst
manage-groups.rst
manage-macros.rst added macro close tag infos since 2.6 Aug 10, 2018
manage-organizations.rst
manage-overviews.rst
manage-report-profiles.rst
manage-roles.rst
manage-scheduler.rst
manage-slas.rst
manage-tags.rst
manage-text-modules.rst
manage-time-accounting.rst
manage-trigger.rst Rewrite Trigger documentation and add custom notification templates s… Aug 27, 2018
manage-users.rst
settings-branding.rst
settings-security.rst
settings-system.rst
settings-ticket.rst
system-api.rst
system-integrations.rst
system-maintenance.rst
system-monitoring.rst
system-objects.rst
system-packages.rst
system-sessions.rst
system-translations.rst
system-version.rst

Readme.md

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.

Documentation

Zammad hosts a searchable version of this documentation on https://docs.zammad.org

ReStructuredText markup

If you like to edit the docs use the ReStructuredText markup language. Infos about this markup language can be found at:

Thanks! ❤️ ❤️ ❤️

Zammad Team

Documentation Status

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

make html

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.