Добавление отсутствующего перевода

Отсутствующий перевод можно добавить двумя способами: изменить строку в менеджере или добавить свой язык.

Отсутствующая строка¶

Одну строку меняют в менеджере, в разделе Admin → Lexicon Management. Дважды щёлкните по значению записи и впишите новое.

Кнопка Create на той же странице добавляет строку, которой в ядре нет вообще. Она спрашивает имя записи, пространство имён, тему, язык и значение.

И то, и другое пишется в базу данных и имеет приоритет над файлом темы. Оно переживает обновление MODX, и в файлах установки ничего менять не нужно.

Revert Lexicon Entry отменяет изменение одной строки, Revert Entries — изменения целой темы и языка.

Целый язык¶

Если вашего языка нет среди предоставленных переводов, перевод интерфейса менеджера — это копия лексикона существующего языка с переведёнными строковыми значениями.

Скопируйте каталог ниже и переименуйте копию в код IANA вашего языка (de для немецкого, it для итальянского):

core/lexicon/en/ -> core/lexicon/[mylanguage]/

Затем отредактируйте файлы .inc.php в копии и переведите строковые значения. Файлы языка — это его темы: core/lexicon/[mylanguage]/[topic].inc.php. Тема default хранит строки, не привязанные к отдельной теме.

Файлы лежат в ядре установки core/lexicon/ — часть ядра, поэтому обновление MODX заменяет каталог, и перевод пропадает. Держите копию в своём репозитории и возвращайте её после каждого обновления — либо меняйте строки в менеджере, которых обновление не касается.

Очистите кэш после правки файла темы Темы кэшируются, поэтому изменённый файл не подхватывается, пока кэш не очищен. Используйте Content → Clear Cache; лексиконы входят в то, что он чистит.

Лексикон установщика¶

Установщик переводится так же: скопируйте setup/lang/en/ в setup/lang/[mylanguage]/. Предупреждение то же — каталог принадлежит ядру.

Лексиконы дополнений¶

Лексиконы дополнения лежат в каталоге lexicon/ по пути, зарегистрированному за пространством имён дополнения:

<путь пространства имён>/lexicon/[язык]/[тема].inc.php

В MODX 3 дополнение распаковывается в core/packages/[сигнатура]/, поэтому его лексиконы лежат рядом с его файлами. Каталог core/components/ — соглашение MODX 2. В MODX 3 он пуст, и дополнение создаёт его только если оно ему нужно.

Скопируйте каталог en и повторите те же шаги, чтобы перевести дополнение. Файлы дополнения обновление MODX не заменяет.

Содействующие переводы¶

Чтобы внести свой вклад в основные переводы, присоединяйтесь к проекту на Crowdin и предложите изменения там. С каждым выпуском включены последние переводы.

Больше информации можно найти на форуме сообщества MODX.

Смотрите также¶

1. Интернационализация
2. Добавление отсутствующего перевода
3. Quip