February 2015 - OpenStack-I18n - lists.openstack.org

Translating RST source with Sphinx builds
by Anne Gentle 10 Mar '15

10 Mar '15

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-w… 2. http://sphinx-doc.org/latest/intl.html

3 9

OpenStack interface in Indian languages
by chandrakant dhutadmal 07 Mar '15

07 Mar '15

Hi All. It gives me great pleasure in informing you all that C-DAC, Pune (Centre for development of advanced computing) has decided to contribute in translating OpenStack interface in all 22 Scheduled Indian languages. @Chandan Kumar has been helpful in getting started. Need to discuss this with language team leaders/ maintainers in order to avoid duplicate efforts. Please comment. RegardsChandrakant DhutadmalC-DAC, Pune.

4 17

Re: [Openstack-i18n] [OpenStack-docs] [ha-guide] RST or Docbook?
by Anne Gentle 02 Mar '15

02 Mar '15

On Thu, Feb 26, 2015 at 3:38 PM, Nick Chase <nchase(a)mirantis.com> wrote: > We decided we'd take this to the mailing list, for obvious reasons. > > I vote RST. We do have a good bit of existing material, but it could > easily be converted to RST, and I know how to set it up, now that I've done > the Networking Guide. :) > > That said, where are we on the translation status? > I emailed Daisy earlier this week but haven't seen a reply (hopefully haven't just missed it.) Anyone else on the i18n list know where we are with testing RST/Sphinx and the translation toolchain? Anne > > Thanks... > > ---- Nick > > _______________________________________________ > OpenStack-docs mailing list > OpenStack-docs(a)lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs > -- Anne Gentle annegentle(a)justwriteclick.com

5 7

Re: [Openstack-i18n] [OpenStack-docs] I question html tag status in API Reference Document
by Andreas Jaeger 25 Feb '15

25 Feb '15

On 02/25/2015 09:41 AM, SungJin Kang wrote: > Hi, > I translation document to Korean. API Reference [1] > > this 'maxServerMeta' [2] is tag '<code>'. > this 'maxPersonality' [3] is tag 'no'. > > two attribute is different?? > > two attribute is same... added '<code>' tag?? Hi, I strongly advise to not translate the API reference document, it includes lots of WADL that our toolchain does not handle and thus you will never be able to fully translate the manual. That's why the guide has a tag "do-not-translate-yet", Andreas > Thanks, > Sungjin. > > > [1] : > https://www.transifex.com/projects/p/openstack-manuals-i18n/resource/api-re… > [2]: > https://github.com/openstack/api-site/blob/master/api-ref/src/docbkx/ch_com… > [3]: > https://github.com/openstack/api-site/blob/master/api-ref/src/docbkx/ch_com… > > > _______________________________________________ > OpenStack-docs mailing list > OpenStack-docs(a)lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs > -- Andreas Jaeger aj(a){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

2 1

State of the RST docs migration
by Anne Gentle 23 Feb '15

23 Feb '15

Hi all, I hope it's not poor form to post a blog post, but I wrote this up to talk about the current state of our migration. http://justwriteclick.com/2015/02/23/state-of-the-migration-to-sphinxrst/ I want to hear from you all "what's essential" for us to begin publishing. I've promised we won't publish until the translation tool chain is complete. Anything else in the bug list that is a "must have?" https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=openstackdocs… Thanks, Anne

2 1

Here be dragons - Summit talk proposal
by Łukasz Jernaś 18 Feb '15

18 Feb '15

Hi I18N list! As the voting period for Summit talks has opened, I'd like to shamelessly propose my talk about my experiences in translating OpenStack in the hope to raise awareness about i18n in the developer community and also to get new translators on board. So if you think you'd be interested in listening or that other people may be interested please cast your vote on https://www.openstack.org/vote-vancouver/presentation/here-be-dragons-trans… Have a nice day! -- Łukasz [DeeJay1] Jernaś

1 0

IRC meeting tomorrow
by Ying Chun Guo 17 Feb '15

17 Feb '15

Hello, all We will have IRC meeting tomorrow, at 0800 UTC in the channel of #openstack-meeting. I'm going to cover following topics: * Research result on translating RST documents * Open discussions If you have anything to discuss with the team, welcome to join. Best regards Ying Chun Guo (Daisy)

1 0

IRC meeting tomorrow
by Ying Chun Guo 04 Feb '15

04 Feb '15

Hello, all We will have IRC meeting tomorrow, at 0800 UTC in the channel of #openstack-meeting. I'm going to cover following topics: * Zanata related discussion * Fuel-cloud translation and review * Introduction of translation test project * Open discussions If you have anything to discuss with the team, welcome to join. Best regards Ying Chun Guo (Daisy)

1 0

Re: [Openstack-i18n] [OpenStack-docs] What's Up Doc? Jan 30 2015
by KATO Tomoyuki 02 Feb '15

02 Feb '15

> We have a new Sphinx theme for docs.openstack.org, called > openstackdocstheme. It should be available on pipy as soon as we can get it > released. Once that's released I'll write instructions for how to apply it > to migrated content. A huge thanks to Doug Hellman for getting it to > releasable! > > We are working through migrations for the End User Guide and Admin User > Guide, sign up for a section at > https://wiki.openstack.org/wiki/Documentation/Migrate. > > While migrating a chapter, I found I wanted some guidelines for how to > migrate, so I wrote some here: > https://wiki.openstack.org/wiki/Documentation/Migrate#Migration_Conventions > Feel free to disagree with my notes so far, but my main theme is "simplify." > > The Foundation is working on letting people know about the new home page > design for docs.openstack.org probably through a Superuser post so that we > can dig into the techie details. :) Please let me know if you have > questions, and realize we're working through the kinks as we go. Do we have i18n tool chain for new format? KATO Tomoyuki

3 3