From 304408df4f646d5815f52991535f4fcf875d421a Mon Sep 17 00:00:00 2001 From: Luigi Toscano Date: Tue, 15 Jan 2019 15:16:11 +0100 Subject: [PATCH] Improve the details about settings i18n for new repos - explicitely point out that babel.cfg needs to be created also for pure Python projects and provide a minimal version of it; - fix the name of the job template which provides translation jobs and describe the possible templates. Change-Id: I70891d0538bf0daa0720b72bcb1539b43a252800 --- doc/source/creators.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/doc/source/creators.rst b/doc/source/creators.rst index 9fb7392..68e3554 100644 --- a/doc/source/creators.rst +++ b/doc/source/creators.rst @@ -1109,6 +1109,12 @@ Replace ``${MODULENAME}`` with the name of your main module like _translators = oslo_i18n.TranslatorFactory(domain='${MODULENAME}') +Create file ``babel.cfg`` with the following content: + +.. code-block:: ini + + [python: **.py] + Django Projects --------------- @@ -1191,16 +1197,19 @@ including the following changes: #. Add the jobs to your pipelines. - Edit file ``zuul.d/projects.yaml`` and add the - ``translation-jobs`` template to your repository: + Edit file ``zuul.d/projects.yaml`` and add a template which + defines translation jobs to your repository: .. code-block:: yaml - project: name: openstack/ templates: - - translation-jobs + - translation-jobs-master-stable + If the repository is planned to have stable branch, use the + ``translation-jobs-master-stable`` template. Otherwise use + the ``translation-jobs-master-only`` template. When submitting the change to ``openstack-infra/project-config`` for review, use the ``translation_setup`` topic so it receives the