Локализация проектов (Перевод шаблонов на другие языки)
🔗 Оригинальная страница — Источник данного материала
Общая информация
Функция локализации проектов позволяет адаптировать проекты для использования иностранной аудиторией с помощью замены информационных текстовых полей проекта на заданные в специальном файле переводы.
Создание файла перевода
Сам файл является таблицей формата .csv с запятой в качестве разделителя и может быть открыт любым табличным редактором. Также файл переводов можно добавить в проект как статический блок “Таблица” или “Google таблица”, выполнив предварительный импорт в документах Google.
Одним из вариантов перевода может стать проект, выполняющий автоматический перевод текста таблицы с помощью действия “Обработка текста - Перевод текста”.
Создать таблицу можно с помощью основного меню ProjectMaker: Файл → Создать файл перевода:
_pic1-67102668afb1552c11fa23954d49f0b0.png)
При нажатии данной кнопки будет выполнен сбор и запись в файл следующих текстовых полей проекта:Текст заметокТекст сообщения действия “Ожидание действий пользователя” Текст действий оповещенияКомментарии действийКомментарии групп действий
Локализованные оповещения и сообщения будут также переведены в ходе выполнения проекта ZennoPoster.
Таким образом для следующего проекта:
_pic2-7114a51e38c7a42d130c998bcfb1cb7b.png)
Будет составлена следующая таблица переводов:
_pic3-21dc37cc9a16d1a53ca5479c66d3a0c0.png)
Текущие значения проекта будут записаны в столбец соответствующий текущей локализации программы.
Изменение таблицы
Таблица состоит из 5 столбцов:
| Имя столбца | Описание |
|---|---|
| ID | ID переводимого элемента, используемое для применения перевода |
| Status | Статус элемента перевода, используемый для контроля за актуальностью данных. Статус "Need update" устанавливается: - По умолчанию у всех элементов; - При отсутствии текстов сторонних локализаций; - При первом обновлении файла после изменения текста в проекте; Статус "Ok" устанавливается: - При наличии хотя бы одного текста сторонней локализации; Статус "Not found" устанавливается: - При отсутствии в проекте элемента с заданным id. |
| RU | Текст русской локализации элемента |
| EN | Текст английской локализации элемента |
| CN | Текст китайской локализации элемента |
Для свободного редактирования доступны столбцы текста сторонних локализаций проекта, а также столбец статуса элемента.
Изменения файла применяются моментально без необходимости перезагрузки проекта или программы.
При изменении столбца ID элемент не будет найден в проекте и получит статус “Not found”, также устанавливаемый при удалении элемента в проекте, ввиду чего не рекомендуется изменять данный параметр. При изменении столбца текущей локализации в таблице, а не в проекте, файл потеряет актуальность и элемент не будет считаться переведённым, ввиду чего при попытке просмотра перевода другой локализации будет предложено обновление файла.
Во избежание ошибок загрузки файла переводов рекомендуется выполнять все изменения таблицы с помощью табличных редакторов.
Обновление файла перевода
Функция обновления файла необходима для записи в файл новых значений, а также для обновления текста текущей локализации элементов.
При наличии файла перевода рядом с проектом в меню будет доступен раздел “Локализация”, содержащий кнопки обновления файла и просмотра других локализаций проекта:
_pic4-580e4b88d6fbfb3c5b32a8d9d47b2c4d.png)
При нажатии кнопки “Обновить файл перевода” будет выполнен сбор текущих значений текстовых полей проекта с последующим сопоставлением с полями файла. У существующих элементов будет обновлен текст текущей локализации, а также статус. Новые элементы будут добавлены со статусом “Need update”, а элементы не найденные в проекте, но имеющиеся в файле получат статус “Not found”.
Перевод проекта
Перевод проекта осуществляется путём замены текста переведённых элементов на заданные в файле локализации текста при просмотре локализации, а также при непосредственном открытии проекта, созданного в локализации, отличной от текущей локализации программы.
При замене выполняется сравнение id элементов, а также сравнение текущего значения элемента в проекте и значения текста локализации элемента в файле. Таким образом, если текст был изменён в проекте и файл не был обновлен, то данный элемент считается неактуальным и не будет переведен при открытии проекта в программе другой локализации. Однако, в случае с просмотром локализации будет предложено обновление файла, без выполнения которого просмотр будет недоступен. Данная логика позволяет предотвратить разногласия исходного текста проекта и текста исходной локализации файла при просмотре перевода, и в то же время переводить максимальное количество переведенных элементов при непосредственном открытии проекта в программе иной локализации.
Если у элемента отсутствует текст перевода для просматриваемой локализации, текст элемента не будет изменен и останется в том виде, в котором представлен в исходной локализации проекта.
Просмотр перевода
Функция просмотра перевода выполняет перевод проекта в точном соответствии с переводом при открытии проекта в программе другой локализации.
В режиме просмотра перевода недоступно выполнение и запись проекта, а также его сохранение и изменение.
_pic5-3f8678a5b1385fd2b4671bc2c8c0607e.png)
Чтобы выйти из режима просмотра локализации необходимо нажать кнопку “Вернуться к редактированию” на информационной панели, или выбрать в меню “Просмотр перевода” текущую локализацию программы.
Если во время просмотра перевода файл таблицы был повреждён или удален, проект вернётся в исходное состояние и выведет сообщение об ошибке.
Также стоит учесть, что в отличии от комментариев групп действий и самих действий, заметки не адаптируют свой размер в зависимости от текста.