[Openstack-i18n] common (RST) translation

Ying Chun Guo guoyingc at cn.ibm.com
Fri Jun 5 06:49:06 UTC 2015

KATO Tomoyuki <tomo at dream.daynight.jp> wrote on 2015/06/04 19:41:53:

> From: KATO Tomoyuki <tomo at dream.daynight.jp>
> To: openstack-i18n at lists.openstack.org
> Date: 2015/06/04 19:42
> Subject: [Openstack-i18n] common (RST) translation
> Hi team,
> I'm translating User Guides (RST) recently.
> I found a below problem.
> Any thought?
> Problem:
>   Each message catalog "pot" file contains all strings of
>   the RST document, including "common" files (glossary and so on).
>   In particular, "user-guide" and "user-guide-admin" resource at
>   Transifex have same strings in "common" files respectively.
>   This causes unintended inconsistency of translation.
>   In fact, Japanese "user-guide" and "user-guide-admin" have
>   different translated strings, which need to sync manually.

I don't understand your problem clearly.

Previously when using DocBook, there is a "common" containing the common
part of documents.
The old "user-guide" and "user-guide-admin" have dependencies to "common".
Now it changed to RST format.
The common contents are not in a separate "common" folder, but in the
document folder itself.
What's the problem do you meet with?

I think "common" is going to be deprecated in the future.
Am I right?

> Solution (just my idea):
>   As is:
>     1. Sphinx(?) generates the "pot" file.
>     2. translate at Transifex.
>     3. Sphinx(?) merge the translated strings.
>   To be:
>     1. Sphinx(?) generates the "pot" file.
>     2. A new script split message stringss for "common".
>        (maybe, based on "msgcat")
>        So, generate 2 resources (main document resource
>        and "common" resource).
>     3. translate at Transifex.
>     4. merge the 2 resources for Sphinx(?).
>     5. Sphinx(?) merge the translated strings.
> Regards,
> KATO Tomoyuki
> _______________________________________________
> Openstack-i18n mailing list
> Openstack-i18n at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-i18n/attachments/20150605/27094523/attachment.html>

More information about the Openstack-i18n mailing list