May 2014 - OpenStack-I18n - lists.openstack.org

Switch to itstool for docs translation?
by Shaun McCance 20 Aug '14

20 Aug '14

Hi all, I've been working on switching the docs translation infrastructure over to itstool. This affects openstack-manuals, operations-guide, and api-site. The current tools are based on xml2po, but they don't call xml2po directly. Instead, they import xml2po and mess around with its internals to get some custom behavior. itstool is designed to handle custom behavior with rules from the W3C Internationalization Tag Set (ITS). You can see the ITS I put together so far here: https://review.openstack.org/#/c/91869/3/os_doc_tools/resources/openstack.i… Using ITS also allows us to do local ITS attributes to override the behavior for specific elements. See a simple example here: https://review.openstack.org/#/c/91872/1/api-quick-start/src/docbkx/api-qui… Most messages in the PO files will be the same. The one big difference will be in how placeholders are done when there's a block-level element inside a block-level element (a practice I discourage anyway). Blueprint and some patches: https://blueprints.launchpad.net/openstack-manuals/+spec/itstool-for-docs https://review.openstack.org/#/q/topic:bp/itstool-for-docs,n,z I'd like to get input from translators, as well as any other docs folks who've worked on this. Most of the document translations are incomplete anyway, but it would nevertheless be best to do this at the beginning of a release cycle. -- Shaun

4 12

Scheduling a Pootle demonstration
by Elizabeth Krumbach Joseph 23 Jul '14

23 Jul '14

Hi everyone, I work on the OpenStack infrastructure team and we're planning on supporting your team with whichever choice for translations tool you decide upon. There was just a Zanata demo this week, and I've reached out to the Pootle project at Daisy's request to organize a similar demo some time next week. The individual from Pootle who has volunteered to give the demo is in the UTC+1 time zone and has asked for some timing proposals from the team for when we can attend a demo so he can check his schedule and we can settle on a time. Suggestions? As a reminder, the infrastructure team set up a demo site for Pootle last October, details about this demo site can be found here if you wish to poke around: http://lists.openstack.org/pipermail/openstack-i18n/2013-October/000209.html Thanks. -- Elizabeth Krumbach Joseph || Lyz || pleia2 http://www.princessleia.com

5 13

The meaning of a string to be translated
by Ying Chun Guo 09 Jun '14

09 Jun '14

"Network Duration": What does "duration" mean? Is it equal to "usage time"? Daisy

4 5

Translation of log messages
by Andreas Jaeger 30 May '14

30 May '14

Hi translators, Clark and Doug, to translate log messages, Doug has been working on having these in separate domains. That way translators can decide what to translate: User visible strings, info log messages, warning log messages, error log messages, or critical log messages. The base work is done in oslo and now we need to setup the tools to extra these for separate domains. Based on input from Doug and Clark and the existing blueprint https://blueprints.launchpad.net/oslo/+spec/log-messages-translation-domain… I created a first patch for our jobs that upload to and import from transifex. I would like review comments on it: https://review.openstack.org/95377/ Before this goes in, we need to add the new domains to transifex, I plan to setup everything for this properly - so this is also a heads-up for coming changes. Translators, once this is in, you will see additional domains - I suggest to ignore those for now and concentrate on the normal ones. As an example, for nova, you will see besides the current nova-translations resource additionally: nova-log-error-translations, nova-log-warning-translations, nova-log-critical-translations, nova-log-info-translations. Note that I will rework this patch if my patch for creating common functions for all translation jobs gets positive review and would appreciate your review of that one as well: https://review.openstack.org/95345 Clark, this is a followup to an IRC discussion you had with Doug on 19 Dec, 2013. Translation team, I'll inform you once everything is setup, Andreas -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

3 4

New localized doc web pages
by Andreas Jaeger 29 May '14

29 May '14

The API Quick Start has been translated to French, German, Japanese and Spanish! We now have German and French index pages: http://docs.openstack.org/de/ http://docs.openstack.org/fr/ (proposed - see https://review.openstack.org/96444) For all the guides that are not mentioned on a specific page, we now have a "secret" page which is not reachable from the main index pages: http://docs.openstack.org/draft-i18n-manuals.html It lists all the other guides that are currently built. That way translation teams can easily verify their manuals. If you like to move one of them to "official" pages, feel free to send a patch! Andreas -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

2 2

Japanese End User Guide and Admin User Guide
by Andreas Jaeger 29 May '14

29 May '14

[Resending to i18n list - send to -docs initially] The Japanese team has done a great job translating these two guides! I just tried to build them and got hit by build errors. Could somebody investigate this, please? Once it works again, tell me and I can enable testing and publishing in openstack-manuals. I filled a bug for tracking: https://bugs.launchpad.net/openstack-i18n/+bug/1324007 Andreas -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

1 1

(no subject)
by Danilo Ingami 26 May '14

26 May '14

1 0

Complete translations are big
by Douglas Fish 26 May '14

26 May '14

I've come across this review for automated translations coming into Horizon https://review.openstack.org/#/c/91523/ It concerns me that it has over a half million LOC in it, and many of these languages have near 0 translation. (I checked here: https://www.transifex.com/projects/p/horizon/) 0 translation languages have just as many lines as full translations; they are just shorter. I can't give you a specific well-defined issue about why this concerns me, but I'm worried about things like how big it might make our distributions, or adding time to how long it takes to clone a new Horizon instance, or use devstack. I've chatted a bit about this in #openstack-horizon. ajaeger has pointed out to me that this isn't the biggest patch we've had for translations. This one, for example, is 5 million lines: https://review.openstack.org/#/c/67521/ This doesn't entirely satisfy me because git clone https://review.openstack.org/openstack/openstack-manuals is taking several minutes for me this morning (full disclosure: I am having some network flakiness today). I'd hate for Horizon to take anywhere near that long to clone. Also in #openstack-horizon jpich has shared that we intend to prune some of these langauges out of Horizon as we approach the release. Maybe it would be best to begin that pruning now, to avoid late dev cycle churn? Does anyone else share my concern about the large size of these translations? Particularly the translations that have near 0 translated strings. Doug Fish

6 15

Korean and Japanese Translations of openstack-manuals broken
by Andreas Jaeger 24 May '14

24 May '14

Please see: http://logs.openstack.org/84/95084/1/check/gate-openstack-manuals-tox-check… 2014-05-23 06:27:40.010 | checksyntax runtests: commands[1] | bash -c find doc -type f -regex '.*\.pot?' -print0|xargs -0 -n 1 msgfmt --check-format -o /dev/null 2014-05-23 06:27:40.041 | /home/jenkins/workspace/gate-openstack-manuals-tox-checksyntax$ /bin/bash -c find doc -type f -regex '.*\.pot?' -print0|xargs -0 -n 1 msgfmt --check-format -o /dev/null 2014-05-23 06:27:40.386 | doc/common/locale/ja.po:14398: end-of-file within string 2014-05-23 06:27:40.386 | doc/common/locale/ja.po:14397: missing `msgstr' section 2014-05-23 06:27:40.387 | msgfmt: found 2 fatal errors 2014-05-23 06:27:40.672 | doc/security-guide/locale/ja.po:2920: end-of-file within string 2014-05-23 06:27:40.672 | msgfmt: found 1 fatal error 2014-05-23 06:27:40.739 | doc/install-guide/locale/ja.po:4335: end-of-file within string 2014-05-23 06:27:40.739 | doc/install-guide/locale/ja.po:4332: missing `msgstr' section 2014-05-23 06:27:40.739 | msgfmt: found 2 fatal errors 2014-05-23 06:27:40.768 | doc/install-guide/locale/ko_KR.po:5278:25: incomplete multibyte sequence at end of file 2014-05-23 06:27:40.768 | doc/install-guide/locale/ko_KR.po:5278: end-of-file within string 2014-05-23 06:27:40.768 | msgfmt: found 2 fatal errors Patch: https://review.openstack.org/95084 Andreas -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter: jaegerandi SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

3 4

Translatable strings rules
by Yves-Gwenaël Bourhis 23 May '14

23 May '14

I made a first draft about Translatable strings rules: https://wiki.openstack.org/wiki/I18n/TranslatableStrings Please feel free to comment :-) -- Yves-Gwenaël Bourhis

1 0