Локализация проектов
Описание.
Функция локализации позволяет адаптировать ваши проекты для использования иностранной аудиторией. Происходит это через замену текстовых полей с информацией проекта на заданные в специальном файле переводы.
Что такое файл перевода?
Он представляет из себя таблицу в формате .csv с запятой в качестве разделителя. Его можно открыть любым текстовым редактором.
Файл перевода можно добавить в проект как статический блок Таблица или Google Таблица, выполнив предварительный импорт в документы Google.
Выполнить автоматический перевод текста таблицы можно также через экшен Обработка текста → Перевод текста.
Как его создать?
Создать таблицу можно с помощью верхнего меню ProjectMaker → Файл → Создать файл перевода:
После нажатия на эту кнопку будет выполнен сбор и запись в файл следующих текстовых полей проекта:
- Записи в заметках;
- Сообщения из экшена «Ожидание действий пользователя»;
- Содержание оповещений;
- Комментарии к экшенам;
- Комментарии для групп действий.
Они также будут переведены в ходе выполнения проекта ZennoDroid.
| Так выглядит проект | А это его таблица переводов |
|---|---|
 |  |
Который соответствует актуальной локализации программы.
Изменение таблицы.
Структура таблицы.
Сама таблица состоит из пяти столбцов:
| Имя столбца | Описание |
|---|---|
| ID | ID элемента, который переводим. Используется для применения перевода. |
| Status | Статус перевода. Позволяет контролировать актуальность данных конкретного элемента. |
| RU | Текст русской локализации элемента. |
| EN | Текст английской локализации элемента. |
| CN | Текст китайской локализации элемента. |
Для свободного редактирования доступны только столбцы с текстом сторонних локализаций проекта, а также столбец статуса элемента.
Возможные статусы:
- Need update. Устанавливается:
- По умолчанию для всех элементов.
- При отсутствии текстов сторонних локализаций;
- При первом обновлении файла после изменения текста в проекте;
- Ok.
Используется при наличии хотя бы одного текста сторонней локализации; - Not found.
Ставится при отсутствии в проекте элемента с заданным id.
Примечания.
- Если изменить столбец ID, то элемент не будет найден в проекте и получит статус Not found, как и при его удалении. Поэтому менять этот параметр не рекомендуется.
- При изменении текущей локализации в таблице, а не в самом проекте, файл станет неактуальным, и элемент не будет считаться переведённым. Затем при попытке просмотра перевода для другой локализации будет предложено обновить файл.
Мы рекомендуем выполнять все изменения таблицы с помощью специальных редакторов.
Работа с переводом.
Обновление файла перевода.
Эта функция необходима для записи в файл новых значений, а также для обновления текста текущей локализации элементов.
При наличии файла перевода рядом с проектом в меню будет доступен раздел Локализация, который содержит кнопки обновления файла и просмотра других локализаций проекта:
При нажатии кнопки Обновить файл перевод текущие значения текстовых полей проекта будут собраны и сопоставлены с полями в файле. У существующих элементов будет обновлен текст и статус локализации. А новые элементы добавятся в статусе Need update. Элементы же, которые присутствуют в файле, но не будут найдены, получат статус Not found.
Перевод проекта.
Перевод осуществляется путём замены текста переведённых элементов на значения, которые заданы в файле локализации текста. При замене выполняется сравнение id элементов и их текущих значений в проекте и файле.
Когда текст в проекте был изменён, а файл при этом не обновлялся, то элемент считается неактуальным. Поэтому он не будет переведён при открытии проекта. Однако при просмотре локализации вам всё же предложат обновить файл, потому что иначе просмотр будет недоступен.
Данная логика позволяет предотвратить разногласия исходного текста с локализацией файла. И в то же время переводить максимальное количество элементов при открытии проекта.
То он не будет изменен и останется в том виде, в котором представлен в исходной локализации проекта.
Просмотр перевода.
Данная функция выполняет перевод проекта в точном соответствии с переводом при открытии проекта в программе с другой локализацией.
Чтобы выйти из режима просмотра локализации необходимо нажать кнопку Вернуться к редактированию на информационной панели. Либо же выбрать в меню Просмотр перевода текущую локализацию программы.
Если во время просмотра перевода файл таблицы был повреждён или удалён, то проект вернётся в исходное состояние и выведет сообщение об ошибке.
Обратите внимание, что в отличии от групп действий и комментариев к ним, заметки не адаптируют свой размер в зависимости от текста.