EPIC: about translation

[maxkoryukov]

Provide toolset for the i18n and l10n features.

Main questions

• how to store translations (locally)
  • consider this: http://stackoverflow.com/a/26056292/1115187 (and overall list
• ext. service for translators -> crowdin
• integrations:
  • ember-helper (obsolete)
  • l10n for handlebars (not sure)
  • l10n for nodejs
  • l10n for vuejs

Services

Discover and test services

• 👎 https://www.oneskyapp.com/

  • no few formats supported (no json for react-intl)

• https://www.transifex.com/ CURRENT CHOICE

• https://poeditor.com/pricing/

  • good for tiny and medium projects
  • main target - PO files, not the json.
  • no ICU support

• 👎 https://lingohub.com/

  • no ICU support
  • no tricky UI (but better than phraseapp)
  • no help with pluralization

• 👎 https://phraseapp.com/

  After PO-editor, crowdin and transifex - phraseapp WebUI is not convenient(

  • no ICU
  • no UI
  • no help with pluralization

• 👍 https://crowdin.com/

  ICU 👍

  We are already on the final stage of polishing the ICU support. We will support ICU-format for messages.
  It should be available on production within a week or earlier.
  You may also find useful this article. Here XLIFF file format is recommended for usage.

• 👎 https://www.locize.io

  • NO collaboration tools
  • YES ICU support
  • NO pluralization helpers
  • UI - minimalism-guided, looks good

Useful tools and links:

• 🚫 http://l10ns.org/ - tool for l10n-automation
• http://formatjs.io/guides/message-syntax/ - message format (how to store translations)
• http://docs.transifex.com/client/set/ - transifex tool
• online ICU tester http://format-message.github.io/icu-message-format-for-translators/editor.html

Discussion about tools:

• Build a tool to support translators based on messageformat.js? messageformat/messageformat#69
• Tooling to maintain JSON files ? messageformat/messageformat#55
• Translation messages manager tool formatjs/intl-messageformat#106 - ICU management tools

Other solutions:

• ghost

Other related issues

• Translations management formatjs/formatjs#112 - Translation management

Discussions in other projects

• i18n, proposed tooling and workflow TryGhost/Ghost#5345 (old ticket)

[maxkoryukov]

Transifex:

Common name schema: translations/<project_slug.resource_slug>/<lang>.<type>

[maxkoryukov]

RIght now there is no service, that works with ICU messages and/or ICU-bundles (files with ICU messages).

Transifex doesn't allow to work with ICU, but it allows to translate JSON files.
On other hand, Transifex handles pluralization just for XLIFF and PO-gettext formats. Pluralization is not necessary right now, but in the future it could be very useful

So, current decision:

1. use Transifex with XLIFF.
2. on Build (gulp) create a JSON object with ICU messages from XLIFF file (there are several npm packages)

And remaining problems:

1 determine, how to format XLIFF with plural and select features (ICU stuff)
2 search for appropriate XLIFF -> JSON converter and appropriate HBS and Ember helpers (and nodejs lib) to get acceess to converted JSON

• ICU-bundle format description(*.txt files): http://source.icu-project.org/repos/icu/icuhtml/trunk/design/bnf_rb.txt
• ICU-message format: http://userguide.icu-project.org/formatparse/messages
• ICU tree (another one format): http://wiki.ecmascript.org/doku.php?id=globalization:messageformatting#modified_icu_approach
  NODEJS tools:

NPM packages

• ICU-bundle to JSON: https://github.com/alex-dow/icu-converter
• Andy VanWagoner ICU tools format-message. And underlying packages: format-message-parse and format-message-interpret.
• Yahoo ICU tools off-site and packages: parser and formatter

NON ICU

• i18n-node by mashpie

[maxkoryukov]

format-message/format-message/issues/60

[maxkoryukov]

TryGhost/Ghost/issues/3801

[maxkoryukov]

ISO8601 and custom formatting for dates in ICU

Bunch of issues, created in other repos, to find a easy way of custom formatting for date-variables:

• How to use custom datetime format in strings? format-message/format-message#61
• yahoo/intl-messageformat#146
• How to use custom datetime format in strings? messageformat/messageformat#162

Every issue about problem with custom format string for dates (details on stackoverflow)

[maxkoryukov]

There is one alive and beauty repository: https://github.com/messageformat/messageformat.js

I think, it is not a bad solution for the server-side translations (outside of HBS).

But! There is no neither HBS-helper nor Ember-package..

[maxkoryukov]

Watch this too: TryGhost/Ghost#5345

[maxkoryukov]

Globalization!

http://rxaviers.github.io/javascript-globalization/

[jamuhl]

We now fully support icu format at https://locize.com (and plan to extend based on your feedback / demand):

• highlighting
• validation
• machine translations
• plural conversion between source and target language
• prettify of your icu strings

Your feedback would be very welcome - also if someone could provide us with a file extracted we could look into supporting that for importing (beside xliff, json, ...)

[maxkoryukov]

@jamuhl , thank you for a good advice;)

I tried to work with locize, but I ran into difficulties (mentioned in the first message). But it seems like new Locize dropped all cons))

Just give me some time for tests, our dev-resources are very limited...

[jamuhl]

@maxkoryukov awesome...no need to rush...would be awesome if you could provide us with feedback if something could be changes or added to make it perfect. Luckily were still at a point were we add features and could optimize the system. So if there is something wrong, or could be better or needed (additional format for import/export) let us know...

[maxkoryukov]

top 30 languages:

• Afrikaans
• Arabic
• Catalan
• Chinese Simplified
• Chinese Traditional
• Czech
• Danish
• Dutch
• English
• Finnish
• French
• German
• Greek
• Hebrew
• Hungarian
• Italian
• Japanese
• Korean
• Norwegian
• Polish
• Portuguese
• Portuguese, Brazilian
• Romanian
• Russian
• Serbian (Cyrillic)
• Spanish
• Swedish
• Turkish
• Ukrainian
• Vietnamese

[jamuhl]

@maxkoryukov hope you already got time to checkout locize new ICU support - feedback would be awesome and like said we would love to extend imports if there is some special message catalog we do not yet support...

[maxkoryukov]

@jamuhl, we are testing Locize on this week

First results: our translators tried to use Locize, but we didn't even start to test ICU, because I18N-team found that UI is not convenient for work.

Moreover, they told me, that Locize doesn't support the translation for DOCX-files.

[jamuhl]

@maxkoryukov yes...we only offer translation of "technical" code projects. The UI does not offer options to translate docs, pdf, ... our focus is really to be strong on continuous localization of software projects not on translating manuals, ...

Would be great to hear what they did not like...guessing they come from a SDL trados world and not from software translation

[jamuhl]

beside to simplify react-intl integration there is now also https://github.com/maciejw/react-intl-namespaces

• enables multiple files
• enables incontext editing

[maxkoryukov]

@jamuhl maybe soon I'll publish the summary of their reviews;)