Translating Openbravo/ru
Contents |
Введение
Данный документ объясняет процесс перевода и поддержки перевода программы Openbravo ERP на различные языки. Процесс перевода включает 5 шагов:
- Создание нового языка в программе.
- Копирование перевода базового языка.
- Экспорт XML файлов для перевода.
- Перевод файлов.
- И последний шаг, импорт переведенных файлов в программу
Создание языка
В порядке описания процесса перевода первым пунктом указано создание нового языка, в действительности в программе уже созданы многие языки (Русский уже создан 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 язык:
- AD_ALERTRULE_TRL_ru_RU.xml: перевод таблицы AD_AlertRule.
- AD_ELEMENT_TRL_ru_RU.xml: перевод таблицы AD_Element. Данная таблица содержит все элементы программы. Данная таблица используется для централизованной поддержки описаний и помощи по элементам программы.
- AD_FIELDGROUP_TRL_ru_RU.xml: перевод для таблицы AD_FieldGroup. Группы полей используются для группировки полей на экране .
- AD_FIELD_TRL_ru_RU.xml: Перевод для таблицы AD_Field. Данная таблица содержит информацию об отображении всех полей во всех экранах программы.
- AD_FORM_TRL_ru_RU.xml: Перевод таблицы AD_Form, где содержатся Названия, описания и помощь по всем формам приложения. Форма – это вручную запрограммированное экранное окно.
- AD_MENU_TRL_ru_RU.xml: Перевод таблицы AD_Menu. В этой таблице содержится дерево меню, которое появляется в левой части программы.
- AD_MESSAGE_TRL_ru_RU.xml: Перевод таблицы AD_Message. Данная таблица содержит все сообщения, которые программа отображает пользователю.
- AD_PROCESS_PARA_TRL_ru_RU.xml: Перевод для таблицы AD_Process_Para. Видимо что-то связанное с параллельными процессами???
- AD_PROCESS_TRL_ru_RU.xml: Перевод таблицы AD_Process. Тут хранятся имена, описания и помощь для процессов, которые запускаются программой Openbravo.
- AD_REFERENCE_TRL_ru_RU.xml: Перевод таблицы AD_Reference. В данной таблице содержатся Ссылки. Ссылки используются для определения типов данных, списков значений или таблиц.
- AD_REF_LIST_TRL_ru_RU.xml: Перевод таблицы AD_Ref_List. В этой таблице содержатся значения для ссылок на типы списка.
- AD_TAB_TRL_ru_RU.xml: Перевод таблицы AD_Tab. Данная таблица содержит имена, описания и помощи для всех таблиц в программе.
- AD_TASK_TRL_ru_RU.xml: Перевод таблицы AD_Task. Описание системных заданий.
- AD_TEXTINTERFACES_TRL_ru_RU.xml: Перевод таблицы AD_TextInterfaces. Данная система содержит все тексты, которые будут отображаться в формах, созданных вручную.
- AD_WF_NODE_TRL_ru_RU.xml: Перевод таблицы AD_WF_Node. Данная таблица содержит узлы Описания бизнес-процесса.
- AD_WINDOW_TRL_ru_RU.xml: Перевод таблицы AD_Window. AD_Window содержит имена и описания созданные автоматически WAD.
- AD_WORKFLOW_TRL_ru_RU.xml: Перевод таблицы AD_Workflow. Имена, описания и помощь по созданным бизнес-процессам.
- AT_COMMAND_TRL_ru_RU.xml: Перевод таблицы AT_Command. Данная таблица не используется в настоящее время.
- C_COUNTRY_TRL_ru_RU.xml: Перевод таблицы C_Country. Данная таблица содержит список стран.
- C_CURRENCY_TRL_ru_RU.xml: Перевод таблицы C_Currency. Данная таблица содержит список валют.
- C_DOCTYPE_TRL_ru_RU.xml: Перевод таблицы C_DocType. Описания типов документов.
- C_ELEMENTVALUE_TRL_ru_RU.xml: Перевод таблицы C_ElementValue. Элементы, используемые в учете.
- C_GREETING_TRL_ru_RU.xml: Перевод таблицы C_Greeting. Приветствия.
- C_PAYMENTTERM_TRL_ru_RU.xml: Перевод таблицы C_PaymentTerm. Названия и описания условий оплаты.
- C_TAXCATEGORY_TRL_ru_RU.xml: Перевод таблицы C_TaxCategory. Имена и описания налоговых категорий.
- C_TAX_TRL_ru_RU.xml: Перевод таблицы C_Tax. Имена и описания налогов.
- C_UOM_TRL_ru_RU.xml: Перевод таблицы C_UOM. Единицы измерения.
- 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