SHA256
Полностью поддерживает английский язык
This commit is contained in:
+21
-4
@@ -1,8 +1,10 @@
|
||||
# Локализация SHiNE — этап 1 (09.11.2026)
|
||||
# Локализация SHiNE (текущее состояние MVP, 10.11.2026)
|
||||
|
||||
## Назначение
|
||||
|
||||
Первый этап вводит инфраструктуру локализации без массового перевода экранов. UI остаётся на vanilla JavaScript. В этом этапе переведены только элементы выбора языка и подпись текущего языка в настройках; другие экраны, уведомления и серверные сообщения по-прежнему преимущественно русские. Полнота английского перевода **не заявляется**.
|
||||
SHiNE использует глобальный язык и JSON-словари. Архитектура и основные переводы RU/EN уже созданы; по ключам `ru.json` и `en.json` синхронизированы. Пользовательские подписи страниц, компонентов, полей профиля, тем, звонков и сервисных уведомлений теперь также вынесены в словари. Остаются технические исключения (журналы, названия городов, протокольные маркеры, резервные сообщения начальной загрузки до `initI18n()`); английский словарь прошёл редакторский проход: исправлены грубые машинные переводы, терминология и разметка встроенных HTML-фрагментов. Окончательная проверка всех редких состояний требует запуска приложения в браузере. Исторические заметки по этапам 1–5 ниже описывают развитие, а не текущие ограничения.
|
||||
|
||||
С 10 ноября в основной PWA добавлен общий форматтер дат, времени, чисел и относительных дат. Диагностика PWA и меню канала больше не принимают решения по переводимым словам.
|
||||
|
||||
## Структура и контракты
|
||||
|
||||
@@ -26,9 +28,24 @@
|
||||
|
||||
Название пункта выбора языка **всегда** содержит английское `Language` после косой черты: `Язык / Language`, `Language / Language`; для новых языков также нужно добавить `language.menu` с локальной частью и `/ Language`.
|
||||
|
||||
## Следующие этапы
|
||||
## Правила сопровождения (актуальны для MVP)
|
||||
|
||||
Последовательно переводить разделы интерфейса, заменяя строковые литералы на `t('namespace.key')`, и дополнять оба словаря; не переносить сообщения пользователей или контрактные идентификаторы API/блокчейна в локализацию. При добавлении языка требуется запись в `languages.json`, его `locales/{code}.json` и полный перевод существующих ключей. Желательно добавить автоматическую проверку равенства ключей при расширении словарей.
|
||||
- Новый пользовательский текст — одновременно в `locales/ru.json` и `locales/en.json`, вызов через `t()` или `th()` для HTML (не для пользовательского HTML). Параметры `{name}`, `{amount}` должны совпадать. Для новых ключей использовать осмысленные имена, не `text_###`.
|
||||
- Долгоживущие массивы описаний полей и палитр создаются до `initI18n()`: их `label`/`placeholder` должны вычисляться через `get label()` / `get placeholder()` или соответствующие функции **в момент отображения**, а не через один `t()` при импорте модуля. Сырой технический id палитры, поля и статус транзакции остаются неизменными.
|
||||
- Для ошибок сервисов сохраняйте технический код и исходный текст для журнала. В пользовательском интерфейсе используйте `toUserMessage()`: неизвестные русскоязычные технические ошибки в режиме English показываются нейтральным переводимым сообщением.
|
||||
- Списки языков — в `languages.json`. Выбранный язык один на все профили. Стартовый выбор из браузера, при неизвестном — `en`.
|
||||
- `js/i18n/format.js`: `formatDate(value, options?)`, `formatTime(value, options?)`, `formatDateTime(value, options?)`, `formatNumber(value, options?)`, `formatRelative(value, unit, options?)`. Локаль берётся из выбранного языка и совпадающего браузерного региона при его наличии. Резервные локали: `ru-RU`, **`en-US`**. Для английских дат при `en-US` по умолчанию используется европейский порядок (в реализации `en-GB` для отображения даты), время 24-часовое; часовой пояс и точные значения не меняются. Отдельной настройки региона нет.
|
||||
- Вычислять форматированную строку **при отображении**, не хранить её как долгоживущую техническую константу. Для именования, сортировки и группировки использовать стабильный идентификатор (например, `YYYY-MM`), а не локализованную подпись месяца.
|
||||
- Управление программой — по кодам: `menuItem.id`, `manifestCode`, `swCode`, `installCode`, `subscriptionCode` и т. п., **никогда не по `item.label` / `t(...)` / `textContent`**. Переводы остаются только для вывода. Для старых локально сохранённых текстовых статусов допустима однократная нормализация в код при чтении (например, legacy push статусы).
|
||||
- В файлах транзакций, ответах API, ключах, адресах и пользовательских сообщениях язык не меняется. Отображение сумм может локализоваться, но парсинг ввода суммы и вычисления — нет. Дополнительный линтер для поиска русских строк пока не вводится.
|
||||
- После редакторской вычитки английского словаря проверять его в реальных экранах на обрезку надписей, правильность контекста и редкие сценарии. Технические логи, данные и протокольные значения не следует механически переводить как UI.
|
||||
- Если значение JSON содержит HTML-разметку, **сохранить все теги, вложенность, CSS-классы, `data-*` и остальные атрибуты из RU-оригинала**. Переводить только отображаемые пользователю текстовые узлы. Потеря закрывающего тега или изменение класса в словаре способно сломать UI на одном языке. Для английского использовать единые обозначения: Wallet, Sign in, Appearance, Notifications, Feed, Shining member, Turbo credits, blockchain snapshot.
|
||||
|
||||
Проверки: `node --test shine-UI/tests/*.test.mjs`, `node --check` для изменённых JS, `python3 scripts/check_docs.py`.
|
||||
|
||||
## История этапов 1–5
|
||||
|
||||
Последующие разделы документируют прошлые шаги. Фразы «английский не готов» относятся к соответствующему **прошлому** этапу, не к текущему состоянию.
|
||||
|
||||
Проверка инфраструктуры: `node --test shine-UI/tests/i18n-architecture.test.mjs` из корня репозитория.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user