166 lines
5.8 KiB
ReStructuredText
166 lines
5.8 KiB
ReStructuredText
=========================
|
|
How to check translations
|
|
=========================
|
|
|
|
It is important to check your translations by using a real situation where your
|
|
translation is used. This page describes how to check your translations.
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Using docs.openstack.org
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Translated documents are available at the OpenStack Documentation site.
|
|
It is updated daily. Most contents are linked from either of:
|
|
|
|
* http://docs.openstack.org/<lang> contains released documents.
|
|
Follow "Languages" in http://docs.openstack.org/.
|
|
|
|
To build a translated document, you need to update the file
|
|
``doc-tools-check-languages.conf`` in each repository, and
|
|
add an entry to ``BOOKS`` like ``["ja"]="install-guide"``.
|
|
|
|
For a document in a stable branch, such as the installation guide for
|
|
Liberty, you need to update the file ``doc-tools-check-languages.conf``
|
|
in the target stable branch directly.
|
|
|
|
You can check a generated document for a specified branch on
|
|
http://docs.openstack.org/<branch>/<language>/<document>.
|
|
For example, the link of Ubuntu Installation Guide for Liberty is
|
|
http://docs.openstack.org/liberty/ja/install-guide-ubuntu/.
|
|
|
|
To add a link to a generated document, you need to update the file
|
|
``www/<lang>/index.html`` in the ``master`` branch of
|
|
the ``openstack-manuals`` repository.
|
|
Note that the web pages are published from ``master`` branch,
|
|
which contains the pages for all releases, such as Liberty.
|
|
Therefore, you don't need to update the file ``www/<lang>/index.html``
|
|
in the stable branch.
|
|
|
|
You can also check:
|
|
|
|
* `build status for publishing on Zuul <http://zuul.openstack.org/builds.html?job_name=publish-openstack-manuals>`__
|
|
* `checkbuild with drafts on Zuul <http://zuul.openstack.org/builds.html?job_name=build-tox-manuals-checkbuild>`__
|
|
|
|
Application developer documentation
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
We can translate the application developer documentations,
|
|
such as API Guide, as ``api-site`` resources in Zanata.
|
|
|
|
OpenStack developer documentation
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Currently, we do not support translations for OpenStack developer
|
|
documents: http://docs.openstack.org/developer/<project>
|
|
|
|
OpenStack Dashboard
|
|
-------------------
|
|
|
|
Running OpenStack-Ansible
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
`OpenStack-Ansible (OSA) <https://docs.openstack.org/openstack-ansible/latest/>`__
|
|
provides Ansible playbooks and roles for the deployment and
|
|
configuration of an OpenStack environment. As part of the project a feature
|
|
named 'Translation Check Site' is developed. An OSA instance will fetch
|
|
translation strings from `translation platform <https://translate.openstack.org/>`__,
|
|
compile and serve these strings in Horizon. You need a machine with
|
|
two or four CPU cores, at least 8 GB memory and 70 GB disk to run OSA.
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
$ BRANCH=master
|
|
$ git clone -b ${BRANCH} https://github.com/openstack/openstack-ansible /opt/openstack-ansible
|
|
$ cd /opt/openstack-ansible
|
|
$ ./scripts/gate-check-commit.sh translations
|
|
|
|
You can set the components of your AIO installation in
|
|
``tests/vars/bootstrap-aio-vars.yml``. Dependly on your environment
|
|
the installation takes 1-2 hours.
|
|
For more details on the AIO configuration, please see `OSA AIO documentation <https://docs.openstack.org/openstack-ansible/latest/user/aio/quickstart.html#building-an-aio>`_.
|
|
|
|
To fetch translated files regularly, execute this command manually or
|
|
as a cron:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cd /opt/openstack-ansible/playbooks; \
|
|
openstack-ansible os-horizon-install.yml \
|
|
-e horizon_translations_update=True \
|
|
-e horizon_translations_project_version=master \
|
|
--tags "horizon-config"
|
|
|
|
Running DevStack
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
Another convenient way is to check dashboard translations is to run DevStack in
|
|
your local environment. To run DevStack, you need to prepare ``local.conf``
|
|
file, but no worries. Several ``local.conf`` files are shared on the Internet
|
|
and a minimum example is shown below. From our experience, you need a machine
|
|
with two or four CPU cores, 8 GB memory and 20 GB disk to run DevStack
|
|
comfortably. If you enable just major OpenStack projects, the machine
|
|
requirement would be much smaller like 2~4GB memory.
|
|
|
|
.. code-block:: console
|
|
|
|
$ BRANCH=master
|
|
$ git clone http://git.openstack.org/openstack-dev/devstack.git
|
|
$ cd devstack
|
|
$ git checkout $BRANCH
|
|
<prepare local.conf>
|
|
$ ./stack.sh
|
|
<wait and wait... it takes 20 or 30 minutes>
|
|
|
|
Replace ``$BRANCH`` with an appropriate branch such as ``master``,
|
|
``stable/newton`` or ``stable/mitaka``.
|
|
|
|
The following is an example of ``local.conf`` for Newton release which runs
|
|
core components (keystone, nova, glance, neutron, cinder), horizon, swift and
|
|
heat. The components which the main horizon code supports are chosen.
|
|
|
|
.. literalinclude:: ../../checksite/local.conf
|
|
:language: ini
|
|
|
|
Import latest translations
|
|
++++++++++++++++++++++++++
|
|
|
|
Translations are being imported into a project repository daily,
|
|
so in most cases you do not need to pull translations from Zanata
|
|
manually. What you need is to pull the latest horizon code.
|
|
|
|
If you have a machine running DevStack, there are two ways.
|
|
|
|
One way is to update the horizon code only.
|
|
The following shell script fetches the latest horizon code,
|
|
compiles translation message catalogs and reloads the apache httpd server.
|
|
Replace ``$BRANCH`` with an appropriate branch such as ``master``,
|
|
``stable/newton`` or ``stable/mitaka``.
|
|
|
|
.. literalinclude:: ../../checksite/horizon-reload.sh
|
|
:language: bash
|
|
|
|
The other way is to rerun DevStack. Ensure to include ``RECLONE=True`` in
|
|
your ``local.conf`` before running ``stack.sh`` again so that DevStack
|
|
retrieve the latest codes of horizon and other projects.
|
|
|
|
.. code-block:: console
|
|
|
|
$ cd devstack
|
|
$ ./unstack.sh
|
|
<Ensure RECLONE=True in your local.conf>
|
|
$ ./stack.sh
|
|
<It takes 10 or 15 minutes>
|
|
|
|
CLI (command line interface)
|
|
----------------------------
|
|
|
|
TBD
|
|
|
|
Server projects
|
|
---------------
|
|
|
|
TBD
|