Translating Openbravo/ru

Contents 1 Введение 2 Создание языка 3 Языковой пакет 3.1 Структура 3.2 Перевод PO файлов 3.2.1 Необходимое программное обеспечение 3.2.2 Конвертация PO файлов в XML файлы 3.2.3 Работа по с PO файлами 3.2.4 Создание XML файлов из PO файлов 3.3 Импорт/Экспорт 3.4 Перевод через интерфейс 4 Установка нового перевода

Введение

Данный документ объясняет процесс перевода и поддержки перевода программы Openbravo ERP на различные языки. Процесс перевода включает 5 шагов:

1. Создание нового языка в программе.
2. Копирование перевода базового языка.
3. Экспорт XML файлов для перевода.
4. Перевод файлов.
5. И последний шаг, импорт переведенных файлов в программу

Создание языка

В порядке описания процесса перевода первым пунктом указано создание нового языка, в действительности в программе уже созданы многие языки (Русский уже создан ru_RU). Вам нужно просто выбрать его из списка.

В данном окне можно выбрать язык из списка языков. При отсутствии языка можно его создать, но необходимо придерживаться правил, установленных в языке Java: сначала 2 строчные буквы кода языка, затем подчеркивание «_», после чего 2 заглавные буквы кода страны. Например, fr_CN обозначает: французский язык для Канады. Выбором галочки System Language и сохранив запись, пользователь выбирает язык для перевода и с этого момента язык появляется в пользовательских настройках.

Следующий шаг: копирование всего текста из Базового языка в Новый язык. Базовый язык – это язык, который является стартовой точкой для перевода интерфейса, в нашем случае это будет английский (en_US). При нажатии кнопки Verify Languages все текстовые строки базового языка будут скопированы в новый язык (где-то 10 секунд должно копировать).

Языковой пакет

Структура

Языковые файлы представляют собой набор XML файлов, в которых содержится перевод на требуемый язык. Каждый файл содержит перевод одной таблицы из базы данных Openbravo и имя файла совпадает с названием таблицы, перевод полей которой содержится в файле.

Данные файлы хранятся в специальном директории (папке) на сервере. Внутри специальной директории lang: для русского это будет путь: /attachments/lang/ru_RU.

Структура XML файла следующая:

• Тэг содержащий имя таблицы и имя языка.
• Для каждой строки таблицы файл содержит Тэг row с атрибутом id для идентификации данной строки, а также trl тэг, который может быть равен Y или N в зависимости от того был ли переведена данная строка.
• Внутри тэга row находятся тэги value (значение) для каждой колонки таблицы.

Данный тэг включает атрибуты: название колонки и оригинальное название на английском языке. Именно этот тэг содержит переводимый текст и Вы должны изменять значение этого тэга при переводе.

Следующий фрагмент покажет пример /attachments/lang/ru_RU/AD_TASK_TRL_ru_RU.xml файла:

<?xml version="1.0" encoding="UTF-8"?>
<compiereTrl language="ru_RU" table="AD_TASK">
  <row id="102" trl="Y">
    <value column="Name" original="Java Version">Версия Java</value>
    <value column="Description" original="Displays the version of the default Java VM">Показывает версию Java машины</value>
    <value column="Help" original="The java version used by the application might be different."</value>
  </row>
  <row id="103" trl="N">
    <value column="Name" original="Database Export">Экспорт БД</value>
    <value column="Description" original="Export (save) the database">Экспорт (сохранение) БД</value>
    <value column="Help" original="Run this command from the server">Run this command from the server</value>
  </row>
</compiereTrl>

Полный список XML файлов которые полностью описывают перевод на ru_RU язык:

1. AD_ALERTRULE_TRL_ru_RU.xml: перевод таблицы AD_AlertRule.
2. AD_ELEMENT_TRL_ru_RU.xml: перевод таблицы AD_Element. Данная таблица содержит все элементы программы. Данная таблица используется для централизованной поддержки описаний и помощи по элементам программы.
3. AD_FIELDGROUP_TRL_ru_RU.xml: перевод для таблицы AD_FieldGroup. Группы полей используются для группировки полей на экране .
4. AD_FIELD_TRL_ru_RU.xml: Перевод для таблицы AD_Field. Данная таблица содержит информацию об отображении всех полей во всех экранах программы.
5. AD_FORM_TRL_ru_RU.xml: Перевод таблицы AD_Form, где содержатся Названия, описания и помощь по всем формам приложения. Форма – это вручную запрограммированное экранное окно.
6. AD_MENU_TRL_ru_RU.xml: Перевод таблицы AD_Menu. В этой таблице содержится дерево меню, которое появляется в левой части программы.
7. AD_MESSAGE_TRL_ru_RU.xml: Перевод таблицы AD_Message. Данная таблица содержит все сообщения, которые программа отображает пользователю.
8. AD_PROCESS_PARA_TRL_ru_RU.xml: Перевод для таблицы AD_Process_Para. Видимо что-то связанное с параллельными процессами???
9. AD_PROCESS_TRL_ru_RU.xml: Перевод таблицы AD_Process. Тут хранятся имена, описания и помощь для процессов, которые запускаются программой Openbravo.
10. AD_REFERENCE_TRL_ru_RU.xml: Перевод таблицы AD_Reference. В данной таблице содержатся Ссылки. Ссылки используются для определения типов данных, списков значений или таблиц.
11. AD_REF_LIST_TRL_ru_RU.xml: Перевод таблицы AD_Ref_List. В этой таблице содержатся значения для ссылок на типы списка.
12. AD_TAB_TRL_ru_RU.xml: Перевод таблицы AD_Tab. Данная таблица содержит имена, описания и помощи для всех таблиц в программе.
13. AD_TASK_TRL_ru_RU.xml: Перевод таблицы AD_Task. Описание системных заданий.
14. AD_TEXTINTERFACES_TRL_ru_RU.xml: Перевод таблицы AD_TextInterfaces. Данная система содержит все тексты, которые будут отображаться в формах, созданных вручную.
15. AD_WF_NODE_TRL_ru_RU.xml: Перевод таблицы AD_WF_Node. Данная таблица содержит узлы Описания бизнес-процесса.
16. AD_WINDOW_TRL_ru_RU.xml: Перевод таблицы AD_Window. AD_Window содержит имена и описания созданные автоматически WAD.
17. AD_WORKFLOW_TRL_ru_RU.xml: Перевод таблицы AD_Workflow. Имена, описания и помощь по созданным бизнес-процессам.
18. AT_COMMAND_TRL_ru_RU.xml: Перевод таблицы AT_Command. Данная таблица не используется в настоящее время.
19. C_COUNTRY_TRL_ru_RU.xml: Перевод таблицы C_Country. Данная таблица содержит список стран.
20. C_CURRENCY_TRL_ru_RU.xml: Перевод таблицы C_Currency. Данная таблица содержит список валют.
21. C_DOCTYPE_TRL_ru_RU.xml: Перевод таблицы C_DocType. Описания типов документов.
22. C_ELEMENTVALUE_TRL_ru_RU.xml: Перевод таблицы C_ElementValue. Элементы, используемые в учете.
23. C_GREETING_TRL_ru_RU.xml: Перевод таблицы C_Greeting. Приветствия.
24. C_PAYMENTTERM_TRL_ru_RU.xml: Перевод таблицы C_PaymentTerm. Названия и описания условий оплаты.
25. C_TAXCATEGORY_TRL_ru_RU.xml: Перевод таблицы C_TaxCategory. Имена и описания налоговых категорий.
26. C_TAX_TRL_ru_RU.xml: Перевод таблицы C_Tax. Имена и описания налогов.
27. C_UOM_TRL_ru_RU.xml: Перевод таблицы C_UOM. Единицы измерения.
28. M_PRODUCT_TRL_ru_RU.xml: Перевод таблицы M_Product. Продукты (материалы, детали, ГП).

Перевод PO файлов

PO (Portable Object) – это очень популярный формат для перевода многих Open Source проектов. Openbravo ERP использует XML файлы для импорта и экспорта переводов. Однако, эти XML файлы могут быть легко преобразованы в PO файлы, с которыми более легко и дружелюбно можно работать.

PO файлы имеют очень простую структуру. Они выглядят так:

#: AD_MENU_TRL_en_US.xml:1(value) 
msgid "original text"
msgstr "translated text"

По данной ссылке можно прочитать полную спецификацю PO формата.

Необходимое программное обеспечение

Для перевода Openbravo используя PO файлы, необходимы следующие программы:

• Openbravo2PO иструмент специально создан для работы с XML файлами, созданными Openbravo ERP. Данный инструмент переводит XML файл в PO и обратно в XML формат. Также данная программа может «склеить» PO файлы одного типа (таблица, элемент, язык) в единый файл.
• Java версия 1.5
• Ant версия 1.7.0

Конвертация PO файлов в XML файлы

Языковые файлы выгружаются из Openbravo ERP в XML формате, для наиболее удобного перевода необходимо преобразовать их в формат PO файлов.

Подробная инструкция Openbravo2PО Инструкция

Кратко: Для преобразования xml файлов в формат po файлов запустите команду ant:

• Для преобразования всех xml файлов в директории в po формат:

ant runXML2PO -DinpFold=/home/vlad/ob/xml_base/ -DoutFold=/home/vlad/ob/po_out/ -DmsgStr=false

• Для преобразования одного xml файла:

ant runXML2PO -DinpFold=/home/vlad/ob/xml_base/ -DoutFold=/home/vlad/ob/po_out/ -DmsgStr=false -Dfile="AD_TASK_TRL_ru_RU.xml"

Необходимо отметить, что одному XML файлу соответствует до трех PO файлов.

Примечание: Сразу получить все PO файлы для Openbravo ERP 2.40 можно здесь

Работа по с PO файлами

Для перевода PO файлов используется множество программ. Некоторые из них:

• PoEdit. Кросс-платформенный редактор.
• KBabel. Графический редактор для KDE.
• Gtranslator. Графический редактор для GNOME.

Создание XML файлов из PO файлов

После перевода файлы из РО формата необходимо преобразовать в XML.

Подробные инструкции Openbravo2PO Инструкция пользователя

Кратко: Для создания XML файлов из PO файлов запустите ant:

Для перевода всей директории в XML из PO:

ant runPO2XML -DinpFold=/home/vlad/ob/po_out/ -DoutFold=/home/vlad/ob/xml_trl 

Для перевода одного (нескольких) файлов:

ant runPO2XML -DinpFold=/home/vlad/ob/po_out/ -DoutFold=/home/vlad/ob/xml_trl -Dfile="AD_TASK_Name_ru_RU.po AD_TASK_Help_ru_RU.po AD_TASK_Description_ru_RU.po"

Примечание: Сразу получить все XML файлы для Openbravo ERP 2.40 можно здесь

Импорт/Экспорт

Для экспорта или импорта XML файлов пользователь должен зайти как System Administrator

Перевод через интерфейс

Установка нового перевода

---

---

---

---

---

---

---

Category: Russian