Власна мова з панелі

Три кроки

1. Завести мову. Код із 2–3 малих латинських літер (fr, de, pt-br), назва англійською та самою мовою, напрям письма й правило множини. Код потім не змінюється: він стоїть в адресах і записах. Коди, зайняті поставкою, і службові слова відхиляються.
2. Завантажити зразок і перекласти. Файл nex1on-<код>.json містить усі ключі інтерфейсу (ядро й увімкнені модулі) з англійським текстом:

{
  "_meta": { "format": 1, "language": "fr", "base": "en", "keys": 5800 },
  "strings": { "admin.save": "Save", "news::post.title": "Title" }
}

Перекладайте лише значення. Дві речі зберігайте: {підстановки} ({name}, {count}) і кількість форм множини в текстів із числом (наприклад, «{count} file|{count} files»: скільки форм має правило мови, стільки варіантів через «|»).

1. Завантажити, перевірити, ввімкнути. Файл перевіряється рядок за рядком. Прийняте зберігається, а завантаження доповнює попереднє: можна перекладати частинами. Якщо чогось бракує, кнопка «Завантажити лише відсутнє» дає файл із пропущеними ключами.

Що перевіряється (захист)

Відхилені рядки перелічуються з причиною (перші 100), у файл перекладу вони не потрапляють і показуються англійською. Порожнє значення — «не перекладено».

Повнота й вмикання

Сторінка мови показує частку перекладеного. Повний переклад (100 %) вмикається одразу. Від 90 % — за явною позначкою: відсутнє показується англійською. Менше 90 % — не вмикається. Увімкнена мова з’являється у виборі мови сайту та в мові панелі в кожної людини; «Приховати на сайті» прибирає її у відвідувачів, панель при цьому далі говорить нею. Нові модулі й оновлення додають ключі — повнота знижується, а відсутнє знову можна завантажити окремим файлом.

Де лежать переклади та що з оновленням

Переклади лежать у storage/languages/<код>/core.json і <модуль>.json, реєстр мов — у налаштуванні languages.custom. Оновлення рушія ці файли не чіпає, поставка (locales/*.json) лишається як є. Видалення мови спершу вимагає її вимкнути й переносить файли до storage/languages/_trash/ поруч, а не стирає; записи, написані цією мовою, зберігають свій текст. Власні правки окремих слів робляться, як і раніше, в «Тексти інтерфейсу».