882b730fdf
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
52 lines
1.5 KiB
ReStructuredText
52 lines
1.5 KiB
ReStructuredText
:title: Translate
|
|
|
|
.. _translate:
|
|
|
|
Translate
|
|
#########
|
|
|
|
As of the Liberty release, translations for various projects in OpenStack are
|
|
done on the Zanata translations platform.
|
|
|
|
At a Glance
|
|
===========
|
|
|
|
:Hosts:
|
|
* https://translate.openstack.org
|
|
* https://translate-dev.openstack.org
|
|
:Puppet:
|
|
* https://git.openstack.org/cgit/openstack-infra/puppet-zanata/tree/
|
|
* :cgit_file:`modules/openstack_project/manifests/translate.pp`
|
|
* :cgit_file:`modules/openstack_project/manifests/translate-dev.pp`
|
|
:Projects:
|
|
* http://zanata.org/
|
|
* https://github.com/zanata/
|
|
:Bugs:
|
|
* https://zanata.atlassian.net/projects/ZNTA/issues/
|
|
|
|
Overview
|
|
========
|
|
|
|
The OpenStack Infrastructure runs a production instance and a development
|
|
instance of Zanata running on the `Wildfly JBoss Application Server
|
|
<http://wildfly.org/>`_. 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 :config:`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 :ref:`jeepyb`, this is run when :config:`gerrit/projects.yaml`
|
|
changes.
|
|
|
|
Finally, the translations jobs must be added to the project in
|
|
:config:`jenkins/jobs/projects.yaml` and :config:`zuul/layout.yaml`.
|