system-config/doc/source/translate.rst
Ian Wienand 882b730fdf Update to openstackdocstheme
This modernises the openstack-infra documentation by switching to
openstackdocstheme.  Update dependencies as required.

To remove non-relevant stuff from conf.py, I have just taken the demo
file from openstackdocstheme and lightly modified it.

It seems later sphinx has included it's own ":file:" role which now
conflicts.  Change it it ":cgit_file:" in our documentation.  Remove
the custom header template which no longer applies.  Add the
post-2.0-pbr sphinx-based warning-as-error, which fixes the original
problem that I actually noticed that errors could slip through the
gate tests :)

Change-Id: Ic7bec57b971bb4c75fc839e7269d1f69a576b85c
2018-06-25 11:19:43 +10:00

1.5 KiB

title

Translate

Translate

As of the Liberty release, translations for various projects in OpenStack are done on the Zanata translations platform.

At a Glance

Hosts
Puppet
Projects
Bugs

Overview

The OpenStack Infrastructure runs a production instance and a development instance of Zanata running on the Wildfly JBoss Application Server. Upgrades must be tested on the development server before being applied in production.

Translators work through the Zanata web UI or with the zanata-cli tool to do their translations. A series of Jenkins jobs handle translations proposals on the proposal slave.

Projects are added for translations by modifying gerrit/projects.yaml and adding the following to the project:

options:
  - translate

Projects are then registered with Zanata with the register-zanata-projects.py from jeepyb, this is run when gerrit/projects.yaml changes.

Finally, the translations jobs must be added to the project in jenkins/jobs/projects.yaml and zuul/layout.yaml.