[OpenStack-docs] [Openstack-i18n] Translating RST source with Sphinx builds

Ying Chun Guo guoyingc at cn.ibm.com
Tue Feb 3 14:22:46 UTC 2015


Anne,

I would take a look at this new format, and see how it could fit to our
translation process.
Thank you for postpone the publish till the agreement on translation
toolchain.

Best regards
Ying Chun Guo (Daisy)




From:	Anne Gentle <annegentle at justwriteclick.com>
To:	"openstack-i18n at lists.openstack.org"
            <openstack-i18n at lists.openstack.org>,
            "openstack-docs at lists.openstack.org"
            <openstack-docs at lists.openstack.org>
Date:	2015/02/02 22:06
Subject:	[Openstack-i18n] Translating RST source with Sphinx builds



Hi all,

We're preparing to migrate user guides to RST to improve ease of authoring
for documentation. The spec [1] is now published, and we've got a research
item for a toolchain that can "slice" RST similar to the DocBook slicing we
do now.

Reading the Sphinx documentation,  it seems that you can run sphinx-build
-b get-text to extract translatable strings to get a collection of .po
files.

This seems very similar to our current docbook slicing script. Does anyone
have time this release to go through the RST files we're creating with the
Sphinx workflow and analyze the results?

I don't intend to publish the RST-based user guides until we have agreement
on the translation toolchain, so we have until April 9, but ideally we'll
have answers this month -- originally on the spec I wanted answers by last
month, but without a lot of complex RST to test there wasn't a great way to
research. Now that we are getting more RST files in
openstack/openstack-manuals/doc/playground-user-guide [3] I would
appreciate help here.

Thanks,
Anne

1.
http://specs.openstack.org/openstack/docs-specs/specs/kilo/migrate-to-new-web-design.html
2. http://sphinx-doc.org/latest/intl.html

_______________________________________________
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-docs/attachments/20150203/1c35e5f6/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: graycol.gif
Type: image/gif
Size: 105 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150203/1c35e5f6/attachment.gif>


More information about the OpenStack-docs mailing list