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

Translation gate for doc jobs
by Andreas Jaeger 22 May '14

22 May '14

Inspired by some discussions here at the summit, I'd like to setup some translation gate for jobs. Patch https://review.openstack.org/93526 (merged) sets up a test that can be invoked with "tox -e checklang" which builds all "supported" manuals. I propose the following: * Setup checking/gating jobs that runs this test and mark it as non-voting. * Create policy on how to handle failures. Proposed policy: * We only gate on manual/language combinations that are translated sufficiently. Right now that's for openstack-manuals Japanese with the Security Guide, HA Guide and Install Guides only. * If an import from transifex fails, creates a failure, we do not approve the import. * If any other patch fails, the failure might get ignored. * In any case of failure, let's send an email to the openstack-i18n mailing list asking them to investigate and fix. What do you think? 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 5

Japanese Security Guide fails to build
by Andreas Jaeger 22 May '14

22 May '14

We now check the translations in the gate and I noticed that the Security Guide fails to build: https://bugs.launchpad.net/openstack-i18n/+bug/1322224 This looks some tools issue, any help on how to fix this is welcome! 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

1 0

Japanese install-deploy guide failing
by Andreas Jaeger 13 May '14

13 May '14

Hi, I noticed that the Japanese Install Guide is failing, e.g.: https://jenkins05.openstack.org/job/openstack-install-deploy-guide-ja/102/ could somebody help, please? 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

Icehouse release note translation?
by Akihiro Motoki 02 May '14

02 May '14

Hi, When Havana release, some language teams translated the release notes. Is there a language team who is translating Icehouse Release Notes [1]? Japanese team is now translating the release note [2] and it is almost completed. Once it is available, I would like to add a link to the translated page as we did for Havana. I am not sure the way we use is best or not, but it works so far. [1] https://wiki.openstack.org/wiki/ReleaseNotes/Icehouse [2] https://wiki.openstack.org/wiki/ReleaseNotes/Icehouse/ja Akihiro

4 7

Including the final : with strings
by Douglas Fish 02 May '14

02 May '14

There is a bug and associated code review open for Horizon regarding how to handle the trailing ":" on some messages: The Bug: https://bugs.launchpad.net/horizon/+bug/1296075 The Code Review: https://review.openstack.org/#/c/84342/ The bug and existing code advocate removing the final ":" from strings that have it for consistency. While I understand the need for consistency, I just got a request from a French translator to do the opposite implementation. The translator for French shared with me that including the punctuation as part of the translatable material makes it much easier to create a correct translation. In French, a space is expected between the final word and the final punctuation, including a colon. When the translators are looking at "Image Details:", its much easier from them to recognize where the space should go so they can create "Détails de l'image :". Without the colon as part of the message its hard to know if they should add a trailing space or not. What's the feeling from the i18n community about how we should treat the final punctuation on our strings? Doug Fish

5 8

I18n meeting tomorrow
by Ying Chun Guo 02 May '14

02 May '14

Hello, all At the meeting at the beginning of April, we decided to move the Europe/India friendly meeting time 1 hour later. So let's meet on at UTC 0800 tomorrow in the channel "#openstack-meeting". We could discuss following items: * Including the final : with strings (http://lists.openstack.org/pipermail/openstack-i18n/2014-April/000573.html) * contextual-markers for better translations (http://lists.openstack.org/pipermail/openstack-i18n/2014-April/000528.html) * I18n related sessions in design summit * Open discussions See you there. Best regards Ying Chun Guo (Daisy)

3 5