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

Ying Chun Guo guoyingc at cn.ibm.com
Thu Feb 5 23:17:58 UTC 2015


I met with problem to build html documents.
There are many opinions to set.
I want to understand how you would build English HTML document.
Then I could follow the similar steps to build translated document.

Any links sharing with me?

Best regards
Ying Chun Guo (Daisy)

From:	Andreas Jaeger <aj at suse.com>
To:	Ying Chun Guo/China/IBM at IBMCN, Anne Gentle
            <annegentle at justwriteclick.com>
Cc:	"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/04 04:02
Subject:	Re: [OpenStack-docs] [Openstack-i18n] Translating RST source
            with Sphinx builds

On 02/03/2015 03:22 PM, Ying Chun Guo wrote:
> Anne,
> I would take a look at this new format, and see how it could fit to our
> translation process.


I did a little playing around and want to share what I did:

1) To build the pot files:

$ sphinx-build -b gettext doc/playground-user-guide/source/

This creates a file per directory or top-level file.

2) so, next i run "msgcat *.pot > playground-user-guide.pot" to create a
single pot file

3) I would upload the pot file

4) We can download it again

5) And then it's running msgmerge to merge the content back to the
multiple files.

We really should have only one file per book - otherwise we get
duplicated "index.pot" files from each book and have multiple books in a

I haven't had time to test all of this together properly and then create
some simple script. If you can tell me how to do it properly, I can help
with enhancing the infra scripts so that this is done automatically -
but I'm also happy to review any patches and answer questions ;)

 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,
       Graham Norton, HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-i18n/attachments/20150206/68648ffe/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-i18n/attachments/20150206/68648ffe/attachment.gif>

More information about the Openstack-i18n mailing list