i18n_po_tools 0.9.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OTJkYTk0MTc2YjRkOWQ3OWNlZDVhNjI2ZGY4ZDNkZjk5NDc2M2IzMw==
+  data.tar.gz: !binary |-
+    OTNmMWRkY2FkZjJmZTM5YzFlNWU4OGE3ZGMwMTEwZGM3MGJjNjVjYg==
+SHA512:
+  metadata.gz: !binary |-
+    Y2JiYWRkMWVlMmEzNTA3Y2E0ZjNhZWFhYTdlNDg2NjNlNTY0ODA0ZWFjMzdl
+    ZDY1NjdiYzE5MTM5MTc3MTE0ZWEwYTFlODFiNzA2MjM1YTBjZDU5MmEwOGFj
+    M2RhMzA1M2NlOTRjMjJlYzMzNTlkODFjMTEzMDliMGJkYzBiZTU=
+  data.tar.gz: !binary |-
+    MmIzMTNhN2RkY2Y3ZWI2NjdjZjJiNzdmOGJhN2I2Yjg0YzIyM2MzNTAzNDM2
+    OTQ4ZTRmODNiNDA5MzZlNmNhN2I3ZDg2NGY0ZTRlY2QzYjc5OGFhYzcwZTEy
+    ZTYwMjA3NDI0Zjc1MWNkZWFjMGQ5YTI2ZWY1ZGYyZWU1ZDQ5Y2M=

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Design.ru.md

@@ -0,0 +1,188 @@
+Почему получилось то, что получилось
+------------------------------------
+
+Проблема
+========
+Есть несколько проектов:
+- мобильное приложение на Android
+- мобильное приложение на iOS
+- настольное приложение для Mac OS X
+- настольное приложение для Windows
+- веб-приложение на Ruby on Rails
+- маркетинговые сайты на Middleman
+
+Они используют следующие механизмы перевода:
+- Android (Java properties XML) (наследие Java)
+- файлы Localizable.strings для iOS и Mac OS X, так же сделали локализацию Windows через них (собственное довольно старое изобретение)
+- файлы .yml (зачем еще и эти изобрели свой формат понятно, но всё равно печально) для Ruby on Rails и Middleman
+
+Все они поддерживают несколько языков:
+- русский
+- английский
+- польский
+- французский
+
+Команда, в основном, знает русский и английский. Причем, русский лучше.
+Остальное отдается на перевод переводчикам. Они переводят с русского или английского варианта.
+
+Переводчики обычно технически не особенно подкованны. Им нужны простые программы, чтобы сделать свою работу.
+
+Каждая же из систем предлагает свой вариант формата файлов для перевода.
+
+Напрямую с ними переводчикам крайне сложно и неудобно работать. Более того,
+полученный перевод, скорее всего, содержит ошибки форматирования. Так же разработка идет достаточно интенсивно, нужно достаточно часто (скажем, раз в неделю) допереводить новые строки.
+
+Так же не хотелось бы вводить дополнительных людей, которые бы стояли между переводчиками и программистами.
+
+1. Используем одну программу для переводчиков
+=============================================
+Желательно, чтобы переводчики работали в программе, а не с файлами напрямую.
+Так не будет синтаксических ошибок в файлах.
+
+Желательно, чтобы программа была одна, а не несколько, чтобы иметь общую базу
+переводов. Да и обучать было бы проще.
+
+Желательно, чтобы программа была как под Windows, так и под другие ОС. Мало ли чем будут пользоваться переводчики.
+
+2. Используем один формат
+=========================
+Из желания использовать одну программу приходим к решению использовать один формат для переводов. Т.к. программ, поддерживающих все и разные не найдено.
+
+Соответственно, нужно будет обеспечить конвертацию форматов в обе стороны.
+
+3. PO (Gettext) спасает день
+============================
+Формат .po довольно популярен и достаточно прост. Все найденные редакторы его поддерживают. Его так же поддерживают различные online-редакторы (при необходимости).
+
+Как альтернатива можно было использовать .xlf .xliff Localisation Interchange File Format, но никаких преимуществ относительно .po не увидел.
+
+Теоритических преград для портирования из необходимых исходных форматов в обе стороны нет.
+
+Стоит отметить, что большинство форматов основаны на первичных ключах вида "main_window.options_group.first_name.hint". PO-файлы переводят фразы с одного языка на другой. При этом изначально разработчики делают перевод хотя бы на русский язык. Но этот перевод так же хотелось бы исправлять нетехническими людьми. К счастью, есть механизм в .po файле и для задачи ключей (msgctxt). Это поможет правильно сделать обратный экспорт в любом случае.
+
+Но при изменении русского и английского текста старый перевод будет отображаться как неиспользуемый, а новая фраза как непереведенная. Такие правки лучше исправлять людьми, т.к. улучшенный исходный текст часто будет приводить и к более точному переведенному тексту.
+
+4. Так какие же именно программы для редактирования переводов?
+=================================
+Проще всего в установке и использовании, бесплатный, достаточный по функционалу http://poedit.net .
+Более навороченный Lokalize из проекта KDE.
+Можно использовать и другие варианты при необходимости.
+
+5. Как хранить переводы?
+========================
+Переводчики народ не очень технически грамотный. Научить их обращаться с Git проблематично. Поэтому можно сделать общую папку в сервисе Dropbox (или аналогичном, их тысячи).
+
+6. Как структурировать папку переводов?
+=======================================
+На первом уровне шаблоны (.pot-файлы, .po-файлы без перевода) или переводы. На втором код языка, чтобы один язык можно было отдельно распространять. Затем название приложения, а уже внутри сами файлы переводов. Шаблоны на 2-х языках (рус. и англ.) в разные папки шаблонов, т.к. с них переводят. Пример:
+Templates/
+  ru/
+    editor-windows/
+      main.pot
+  en/
+    editor-windows/
+      main.pot
+Translations/
+  ru
+    editor-windows/
+      main.po    //перевод с русского на русский, для исправлений текстов нетехническими людьми
+  en
+    editor-windows/
+      main.po    //перевод с русского на английский, для исправлений текстов нетехническими людьми
+  fr
+    editor-windows/
+      main.po    //перевод с английского на французский
+  sp
+    editor-windows/
+      main.po    //перевод с русского на испанский
+
+Такой вариант позволяет без конфликтов разным людям обновлять разные папки. По сути, над отдельной папкой (точнее файлом) не работает на запись более одного человека.
+
+Это достигается односторонним потоком данных:
+src --(developer)--> pot --(translator)--> po --(developer)--> src
+Как исключение, если редактор, установленный у переводчика не поддерживает удобное добавление новых строк из обновленного pot-файла, то при обновлении pot-файла могут обновляться и соотв. po-файлы.
+
+Естественно, если было бы несколько переводчиков на один язык, то пришлось бы использовать Git или другим способом координировать их работу.
+
+7. Не ограничиваем программистов
+================================
+Программисты могут использовать любой удобный для их проекта формат файлов перевода. Хранить файлы у себя в проекте в любом месте и под любым именем. Иметь столько файлов переводов сколько им удобно. Одному файлу исходному будет соответствовать 1 файл pot и по кол-ву языков файлы po.
+
+8. Как создавать файлы переводов?
+=================================
+Под каждый формат нужна утила конвертирования (она может быть и одна, и несколько). Нужно их или найти, или написать свои.
+
+Разработчик у себя в проекте создает shell-скрипт или другим образом 2 задачи:
+- на импорт переводов (копирование из папки Dropbox соотв. .po-файлов и конвертирование в нативный формат)
+- на экспорт переводов (экспорт в .pot-формат и копирвание в папку шаблонов) 
+
+Gem  18n-po содержит библиотеку для простого написания собственных скриптов, т.к. при большом количестве исходных файлов и языков перевода появляется много однотипных задач.
+
+Получается схема работы (пример):
+- разработчик экспортирует перевод из нативного формата в файлы example.pot и example_dialogs.pot, они помещаются в папку Templates/ru/example/ в Dropbox
+- переводчик на английский в редакторе открывает эти файлы, переводит и кладет файлы example.po и example_dialogs.po в папку Translations/en/example/
+- разработчик example (или переводчик у которого настроен запуск) запускает конвертацию из переводов в шаблоны Templates/en/example. Аналогично и с русским языком, если его исправляли. В этот же момент для удобства можно сделать merge из pot в po файлы (если такое делается, то организационно нужно согласовать так, чтобы в это время файлы переводов этого приложения ни одним из переводчиков не обновлялись). Это шел-скрипт без параметров (для простоты запуска).
+- переводчики на другие языки открывают шаблоны на русском или английском и переводят. Файлы .po кладут в папку своего языка и приложения. Если перевод уже был, то при обновлении .pot-файла редакторы сами заметят, что появились новые строки. Если редактор менее навороченный, то в п.1 при экспорте переводов нужно так же запустить утилиту из пакета gettext по слиянию переводов. При этом в .po файлах появятся непереведенне строки.
+- разработчик запускает импорт переводов. Файлы из Dropbox переводятся в нативный формат и помещаются в нужные места в проекте.
+
+9. Что делать с уже существующими переводами в нативном формате?
+================================================================
+Основная утила i18n-po поддерживает импорт/экспорт во все стороны. Разово пишем команды для фомирования исходных po-файлов.
+
+10. Так как помещать новые непереведенные строки из .pot файлов в .po файлы? 
+============================================================================
+В идеале это делает редактор. Иначе стандартный пакет для работы с файлами .po -- gettext -- содержит утилиту для этого. Через PO-редактор Catalog > Update from POT-file. Утила из gettext:
+msgmerge --update example.po example.pot
+
+11. Как конвертировать перевод в Android .xml формат из .po?
+===========================================================
+Пришлось свою утилу писать. Опубликована как i18n-po gem.
+
+12. Как конвертировать перевод в .strings формат из .po?
+========================================================
+Пришлось свою утилу писать. Опубликована как i18n-po gem.
+
+13. Как конвертировать перевод в .yml формат из .po?
+====================================================
+Пришлось свою утилу писать. Опубликована как i18n-po gem.
+
+14. Как конвертировать перевод в .po формат из Android .xml?
+===========================================================
+Пришлось свою утилу писать. Опубликована как i18n-po gem.
+
+15. Как конвертировать перевод в .po формат из .strings?
+===========================================================
+Пришлось свою утилу писать. Опубликована как i18n-po gem.
+
+16. Как конвертировать перевод в .po формат из .yml?
+===========================================================
+Пришлось свою утилу писать. Опубликована как i18n-po gem.
+
+17. Что из всего этого бекапить?
+================================
+Скрипты импорта/экспорта бекапятся как часть исходников. pot-файлы на ключах восстанавливаются из исходников. Нативные переводы восстанавливаются из .po-файлов, но не наоборот (такие утилы вне проекта, хотя и возможны). Поэтому нужно бекапить всю папку Dropbox, остальное не обязательно. Папку для бекапов можно добавлять в отдельный git-репозитарий, тогда будет бекапиться по процессу бекапа исходных текстов.
+
+18. Нужен конвертор yml <--> po?
+================================
+Да. Причем нужна поддержка нескольких .yml-файлов (может генерироваться и несколько соотв. .po-файлов). И поддержка множественных форм. Конвертация в обе стороны. Проектов, которые бы удовлетворяли всем требованиям не было найдено.
+
+19. Как добавлять новый язык?
+=============================
+Переводчики могут независимо из pot-файлов сделать po-файлы с переводом на новый язык. Программисты добавляют всю инфраструктуру вокруг нового языка самостоятельно: возможность его выбора, создание папок для файлов (для Apple и Android), сконвертированных из po, добавление нового языка в Locfile.
+
+Как итог: какие сторонние программы использовались?
+==================================================
+1) poeditor.net
+2) Dropbox
+3) Gettext
+4) Скрипты для автоматизации консольных команд
+5) Собственный gem i18n-po для конвертаций из формата в формат и общая часть скриптов автоматизации
+
+Что делать, если захочется статистику и прочее?
+===============================================
+Искать утилы для .po-файлов. Наверняка такое уже есть. Например, конвертация .po-файла в .pot:
+msgfilter -i main.po -o main.pot --keep-header sed -e 's/.*//g;/^$/d'
+
+Особенности реализации конвертации из Rails (.yml)
+==================================================
+Редакторы не поддерживают конструкции вида %{count}. Для plural сообщений используется автоматическая конвертация в C-format: %d <--> %{count}. В остальных случаях ничего не делается.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in i18n_po_tools.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Igor Stepin <igor_for_os@stepin.name>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/Readme.md

@@ -0,0 +1,77 @@
+# i18n-po-tools
+
+Utils to convert translations from source formats to PO/POT Gettex and vise versa. It allows to separate translations from development of apps.
+
+Supported input/output formats:
+* [iOS and OS X String Resources][http://developer.apple.com/documentation/Cocoa/Conceptual/LoadingResources/Strings/Strings.html] (format: ios)
+* [Android String XML][http://developer.android.com/guide/topics/resources/string-resource.html] (format: android)
+* [Gettext PO/POT][http://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/PO-Files.html] (format:po and pot)
+* [Rails YAML][http://guides.rubyonrails.org/i18n.html] (format: rails-yaml)
+* Basic flat YAML (format: flat-yaml)
+* CVS for easy exchange with other apps (format: csv-yaml)
+
+Direct converation between any formats supported.
+
+About design decision you can read in the Design.txt.
+
+Rails YAML and PO supports plural forms of messages. Example: 1 message, 2 messages.
+
+Sorry, more info only in Russian in the Readme.re.md file.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'i18n_po_tools'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install i18n_po_tools
+
+
+## Usage
+
+Command: i18n-po [OPTIONS]
+
+Options
+    -i, --input FILENAME             input filename (default STDIN)
+    -b, --base FILENAME              base language input filename (only for po output mode)
+    -o, --output FILENAME            output filename (default STDOUT)
+    -f, --from FORMAT                input file format (default is autodetect by ext)
+                                     (rails_yaml, flat_yaml, po, pot, ios, android, csv)
+    -t, --to FORMAT                  output file format (default is autodetect by ext)
+                                     (rails_yaml, flat_yaml, po, pot, ios, android, csv)
+    -l, --language LANGUAGE          input file language (only for po or rails_yaml output mode)
+    -h, --help                       help
+
+Examples:
+1) First import (generation of PO file) from Rails YAML file:
+i18n-po --input   ~/projects/rails_app/config/locales/devise.en.yml --language en \
+         --base ~/projects/rails_app/config/locales/devise.ru.yml \
+         --output  ~/projects/translations/rails_app/devise.en.po
+
+2) Generation of translation template (POT file) from Rails YAML file:
+i18n-po --input ~/projects/rails_app/config/locales/devise.ru.yml \
+         --output  ~/projects/translations/rails_app/devise.en.pot
+
+3) Generation of Rails YAML file from PO file:
+i18n-po --input   ~/projects/translations/rails_app/devise.en.po --language en \
+         --output ~/projects/rails_app/config/locales/devise.en.yml
+
+4) Translation convertation from iOS to Android format:
+i18n-po --input   ~/projects/ios_app/Localizable.strings \
+         --output ~/projects/android_app/en/strings.xml
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Readme.ru.md

@@ -0,0 +1,191 @@
+# i18n-po-tools
+
+Утилы для конвертирования переводов из исходных форматов в PO/POT Gettex и обратно. Позволяет разделить перевод и разработку программ.
+
+Поддерживаемые форматы (в обе стороны):
+* [iOS и OS X String Resources][http://developer.apple.com/documentation/Cocoa/Conceptual/LoadingResources/Strings/Strings.html] (формат: ios)
+* [Android String XML][http://developer.android.com/guide/topics/resources/string-resource.html] (формат: android)
+* [Gettext PO/POT][http://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/PO-Files.html] (формат: po или pot)
+* [Rails YAML][http://guides.rubyonrails.org/i18n.html] (формат: rails-yaml)
+* Простой плоский формат YAML (формат: flat-yaml)
+* CVS для упрощенного обмена с другими программами (формат: csv-yaml)
+
+Возможна прямая конвертация между любыми поддерживаемыми форматами.
+
+Почему проект получился таким каким получился можно прочитать в Design.ru.txt.
+
+Rails YAML и PO поддерживают специальный вид строк для переводов, зависящих от чисел (plurals). Пример: 1 сообщение, 6 сообщений.
+
+
+## Установка
+
+Добавьте строчку в Gemfile:
+
+    gem 'i18n_po_tools'
+
+и запустите:
+
+    $ bundle
+
+Или установка без Gemfile:
+
+    $ gem install i18n_po_tools
+
+
+## Использование
+
+Утила: i18n-po [Опции]
+
+Опции
+    -i, --input FILENAME             input filename (default STDIN)
+    -b, --base FILENAME              base language input filename (only for po output mode)
+    -o, --output FILENAME            output filename (default STDOUT)
+    -f, --from FORMAT                input file format (default is autodetect by ext)
+                                     (rails_yaml, flat_yaml, po, pot, ios, android, csv)
+    -t, --to FORMAT                  output file format (default is autodetect by ext)
+                                     (rails_yaml, flat_yaml, po, pot, ios, android, csv)
+    -l, --language LANGUAGE          input file language (only for po or rails_yaml output mode)
+    -h, --help                       help
+
+Примеры:
+1) Первоначальный импорт перевода (генерация po-файла) из Rails yml-файла:
+i18n-po --input   ~/projects/rails_app/config/locales/devise.en.yml --language en \
+         --base ~/projects/rails_app/config/locales/devise.ru.yml \
+         --output  ~/projects/translations/rails_app/devise.en.po
+
+2) Генерация шаблона для перевода (pot-файла) из Rails yml-файла:
+i18n-po --input ~/projects/rails_app/config/locales/devise.ru.yml \
+         --output  ~/projects/translations/rails_app/devise.en.pot
+
+3) Генерация Rails yml-файла из переведенного po-файла:
+i18n-po --input   ~/projects/translations/rails_app/devise.en.po --language en \
+         --output ~/projects/rails_app/config/locales/devise.en.yml
+
+4) Конвертация файла перевода из iOS-формата в Android:
+i18n-po --input   ~/projects/ios_app/Localizable.strings \
+         --output ~/projects/android_app/en/strings.xml
+
+
+## Как работает механизм переводов на базе i18n-po?
+Системой пользуются 2 роли пользователей: переводчики и разработчики прикладных программ.
+
+Источником данных являются .po-файлы. Файлы в приложениях -- автосгенерированы из .po-файлов.
+
+
+## Со стороны переводчиков
+У переводчиков есть папка в Dropbox (или аналогичном сервисе). Они открывают папку своего языка в [PO Editor](http://poedit.net) (доступен под Windows,
+Mac OS X и Linux), выбирают язык для перевода и переводят.
+
+Структура папки:
+Templates/
+  ru/
+    example-app/
+      main.pot
+  en/
+    example-app/
+      main.pot
+Translations/
+  ru/
+    example-app/
+      main.po    //перевод с русского на русский, для исправлений текстов нетехническими людьми
+  en/
+    example-app/
+      main.po    //перевод с русского на английский, для исправлений текстов нетехническими людьми
+  fr
+    example-app/
+      main.po    //перевод с английского на французский
+  sp
+    example-app/
+      main.po    //перевод с русского на испанский
+
+pot-файлы -- это те же файлы .po, но без переводов.
+
+Когда обновляется перевод в программе, то обновляются только
+.pot-файлы. Уже сам редактор замечает, что они обновились и предлагает
+доперевести их в .po-файле. Если редакторы без этой функции, то можно автоматически обновлять и переводы, но нужно договориться в этот момент не править переводы переводчикам.
+
+Первоначальный импорт уже созданных переводов так же можно сделать, что уже было переведено не пропадет.
+
+Зачем пользоваться специальным программами, если можно открыть .po-файл в текстовом редакторе?
+1) Всегда корректный синтаксис файла, случайно "не сломаешь" его.
+2) В редакторах, как правило, есть база перевода. Позволит аналогично переводить похожие сообщения.
+3) Через некоторое время осознаешь и другие преимущества использования специализированной программы (удобный интерфейс именно для переводов, статистика и т.п.)
+
+
+## Со стороны разработчиков
+Готовите переводы в стандартных для своей платформы форматах.
+Затем с помощью i18n-po переводите в po-файлы. Кол-во po-файлов
+соответствует количеству исходных файлов.
+
+В папке Dropbox должны присутствовать только файлы форматов .po и .pot,
+чтобы не путать переводчиков.
+
+Добавляете скрипты (или другим образом оформляете задачи) извлечения переводов
+из исходников (в po-файлы) и выгрузки в исходники (в Rails yml,
+iOS/MacOSX .strings, Android .xml). Используется консольная
+утилитиа i18n-po. Так же они копируют новые шаблоны для переводов в Dropbox.
+
+Рекомендуется, чтобы разработчики имели доступ к этому репозитарию и папке
+Dropbox. Тогда они сами смогут обновлять шаблоны для переводов и импортировать
+новые переводы.
+
+При подготовке строк для перевода рекомендуется следовать https://techbase.kde.org/Development/Tutorials/Localization/i18n_Mistakes .
+
+Источником переводов может быть несколько любых языков.
+
+Первоначальное добавление языков в код своего проекта -- на стороне разработчиков, т.к. сильно зависит от программной платформы проекта и самого проекта. Для iOS, Mac OS X и Android -- это создание соотв. папок.
+
+
+Замечания по сторонним программным продуктам
+============================================
+1) Вместо Dropbox можно использовать другие аналогичные решения. Переводчикам проще обращаться с таким решением, чем с полноценными репозитариями (например Git).
+
+2) Вместо poedit.net можно использовать Localize из KDE http://l10n.kde.org/docs/translation-howto/gui-specialized-apps.html#lokalize . Его ставить сложнее, но по функционалу лучше.
+
+3) Формат po-файлов позволяет использовать множество утил и программ, он известен практически всем, кто занимается переводами программ. Более того утила i18n-po поддеживает конвертацию во множество форматов, включая CSV.
+
+
+Особенности реализации конвертации из Rails
+===========================================
+Редакторы не поддерживают конструкции вида %{count}. Для plural сообщений используется автоматическая конвертация в C-format: %d <--> %{count}. В остальных случаях ничего не делается.
+
+
+## Интересные проекты
+1) https://github.com/mrmans0n/localio
+Сделан для перевода через гуглотаблицы. Содержит некоторые другие форматы (JSON). Из минусов: не поддерживает plurals, некоторые форматы (po). Возможны проблемы с escaping'ом.
+
+2) https://github.com/netbe/Babelish
+Основой является текстовый файл в csv формате. Соотв., нет поддержки PO и plurals.
+
+3) https://github.com/mobiata/twine
+Основой является текстовый файл в ini-подобном формате.
+Поддерживает экспорт во множество форматов.
+
+4) http://olshansk.github.io/ios_localizer/
+Осуществляет автоматический перевод ios-файлов с помощью Google Translate.
+Если вдруг нужно сделать плохой (зато дешевый -- $20 per 1M characters) автоматический перевод. Далее с помощью i18n-po преобразовать в любой нужный формат.
+
+5) https://localise.biz/free/converter/yml
+Online-конвертор файла в разные форматы. Пока что бесплатно. Плюсы -- множество форматов. Минус -- в любой момент может стать платным или перестать работать. Так же нет генерации po-файла из 2х исходных файлов (перевод человеческого текста, не ключей).
+
+6) http://pology.nedohodnik.net/
+Библиотека на Python для автоматизации манипуляций с po-файлами. Интересно, если писать дополнительные утилы манипуляций с переводами.
+
+7) https://github.com/grosser/get_pomo
+Если для автоматизации больше нравится Ruby, то эта библиотека поможет.
+
+8) https://github.com/pejuko/i18n-translators-tools
+Интересный, но заброшенный проект. К сожалению, вмешивается в то как Rails читает файлы переводов и в каком формате они должны быть.
+
+9) https://github.com/airbnb/polyglot.js
+Интересный проект для переводов web-части приложений. Пока что не поддерживается i18n-po, но есть все шансы.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+

data/bin/i18n-po

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+$KCODE="UTF8" if RUBY_VERSION < "1.9"
+
+require 'i18n_po_tools'
+require 'i18n_po_tools/cli'
+
+I18nPoTools::CLI.start

data/i18n_yml_tools.gemspec

@@ -0,0 +1,47 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'i18n_po_tools/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "i18n_po_tools"
+  spec.version       = I18nPoTools::VERSION
+  spec.authors       = ["Igor Stepin"]
+  spec.email         = ["igor_for_os@stepin.name"]
+  spec.homepage      = "http://github.com/stepin/#{spec.name}"
+  spec.license       = "MIT"
+  spec.summary = "Utils to convert translations from source formats to PO/POT Gettex and vise versa."
+  spec.description = <<EOF
+Utils to convert translations from source formats to PO/POT Gettex and vise versa.
+It allows to separate translations from development of apps.
+
+Supported input/output formats:
+* iOS and OS X String Resources
+* Android String XML
+* Gettext PO/POT
+* Rails YAML
+* Basic flat YAML
+* CVS for easy exchange with other apps
+
+Direct converation between any formats supported.
+
+Rails YAML and PO supports plural forms of messages.
+EOF
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  #for Android files support
+  spec.add_runtime_dependency "nokogiri"
+  #for PO files support
+  spec.add_runtime_dependency "get_pomo", "= 0.9.0"
+  #for blank?/present?
+  spec.add_runtime_dependency "activesupport", "~> 4.1.6"
+
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "gem-release"
+end