Власна мова й мовний пакет: переклад, файли, пакування

Мови немає в каталозі? Її можна додати самому, і програмувати для цього не потрібно: мова — це лише переклади, жодного рядка коду. Є два шляхи. Перший — прямо в панелі: завантажили зразок, переклали, завантажили назад. Другий — готовий пакет (файл .zip), який можна поставити на будь-який сайт на Nex1on, свій чи чужий.

Шлях перший: через панель

Мови й тексти → Мови → Додати мову. Заповніть форму:

Мова створюється чернеткою: на сайті її поки не видно. Далі три кроки на сторінці самої мови.

1. Завантажити зразок. Кнопка «Завантажити всі ключі» віддає файл JSON, де є всі рядки рушія й модулів з англійським текстом. Пізніше, коли частину вже перекладено, «Завантажити лише відсутнє» віддає лише те, чого ще немає.
2. Перекласти й завантажити. Файл влаштований так: нагорі _meta (службове, не змінюйте), нижче strings — «ключ»: «англійський текст». Змінюйте лише значення праворуч. Завантажте файл кнопкою «Завантажити й перевірити» (до 3 МБ). Завантаження доповнює попереднє, тому перекладати можна частинами.
3. Увімкнути. Коли переклад готовий, натисніть «Увімкнути»: мова з’явиться у виборі мови на сайті та в мові панелі. Повний переклад (100 %) вмикається одразу, від 90 % — за галочкою: відсутнє показується англійською.

{
    "_meta": { "format": 1, "language": "fr", "base": "en", "keys": 15628 },
    "strings": {
        "ai.bar.label": "Assistant IA",
        "ai.bar.run": "Lancer"
    }
}

Що перевіряється під час завантаження. Файл розбирається рядок за рядком. Невідомі ключі ігноруються. Рядок відхиляється, і в списку під формою написано причину, якщо в ньому:

• загубилася підстановка у фігурних дужках ({count}, {name}): у перекладі вони мають лишитися такими самими, як в англійському тексті;
• з’явилася HTML-подібна розмітка або небезпечне посилання;
• неправильна кількість форм у рядка з числом: форми пишуть через «|», за кількістю форм правила мови;
• значення не рядок або довше за 4000 знаків.

Видалення. Мову спершу вимикають, потім «Видалити мову» з уведенням її коду. Файли перекладів переносяться поруч у _trash, а не стираються; записи сайту цією мовою зберігають свій текст.

Шлях другий: мовний пакет

Пакет потрібен, щоб віддати мову іншим або поставити її на кілька своїх сайтів: це один файл .zip. Усередині лише опис мови й переклади:

language.json
locales/de.json
modules/news/locales/de.json
modules/forum/locales/de.json

• language.json — опис мови, лежить у корені архіву.
• locales/de.json — переклади рушія.
• modules/news/locales/de.json — переклади модуля «news»: по файлу на модуль, за бажанням.

Інших файлів у пакеті бути не може: будь-який зайвий файл — відмова всьому архіву. Теки з назвою пакета не потрібно, файли лежать прямо в корені архіву.

{
    "code": "de",
    "name": "German",
    "native": "Deutsch",
    "direction": "ltr",
    "plural": "en",
    "version": "1.0.0",
    "engine_min": "0.9.9"
}

Файл перекладів — звичайний об’єкт JSON «ключ»: «текст», той самий формат, що в locales/en.json рушія: ключі беріть звідти. Для модуля — modules/<назва модуля>/locales/<код>.json, ключі з його en.json. Модулів, яких немає на сайті, пакет не торкається.

Правила для значень такі самі, як під час завантаження в панелі: лише рядки, до 4000 знаків, підстановки {…} як в англійському, форми числа через «|». Додатково для пакета: ключі лише з латинських літер, цифр, крапки, підкреслення й дефіса, вкладеність не глибша за вісім рівнів, не більше 40 000 рядків у файлі, без HTML-подібної розмітки та без посилань виду javascript:. Обов’язковий файл перекладів ядра locales/<код>.json.

Якщо мова лежить у вихідному коді рушія (у вас є locales/<код>.json і modules/*/locales/<код>.json), пакет збирає команда:

php nex1on language:pack pl --version=1.0.0

Вона збирає nex1on-language-pl-1.0.0.zip, перед пакуванням перевіряє кожен файл так само, як встановлювач, і друкує шлях (за замовчуванням nex1on-moduli на два рівні вище за теку сайту; змінити — --out=<папка> або app.release_directory у config/local.php). Англійська пакетом не випускається: вона є в поставці.

Як поставити пакет

Доповнення → Модулі → Встановити з архіву, вибрати «Мовний пакет», завантажити файл, подивитися звіт і встановити. Докладно — у статті «Як встановити власне доповнення». Після встановлення мова лишається вимкненою: увімкніть її на сторінці «Мови». Англійську й основну мову сайту пакетом замінити не можна. Мову з поставки замінює лише пакет з підписом Nex1on і версією не нижчою за встановлену.

Помилки