mrleo1nid
1e3b350dfc
ci / contract / contract (сгенерированный код совпадает с openapi.yaml) (push) Successful in 1m1s
ci / db / db (push) Successful in 1m16s
ci / mobile / mobile (Metro-бандл Android) (push) Successful in 1m12s
ci / api / api (push) Successful in 45s
ci / recommender / recommender (push) Successful in 1m50s
ci / ts / ts (packages + web) (push) Failing after 6m53s
ci / docker / docker (образы собираются — их сервер собирает сам при обновлении) (push) Successful in 1m13s
- Introduced a new warning for users uploading non-FLAC or WAV formats, indicating that these formats should only be used as a last resort. - Added functionality to highlight files needing format attention in the upload queue. - Updated the UI to provide clearer guidance on acceptable audio formats during uploads. - Improved documentation to reflect changes in upload requirements and user interface updates.
2.6 KiB
2.6 KiB
Локализация
Принципы
- Поддерживаемые языки на старте: ru, en. Язык по умолчанию — язык системы / браузера, если поддерживается, иначе
en. - Выбор языка: на экране входа (сохраняется локально) и в профиле (сохраняется в
users.locale— синхронизируется между устройствами). - Сервер не возвращает пользовательских текстов: только машинные коды ошибок и ключи (
activity.running). Исключение — метаданные музыки (названия треков / исполнителей) и changelog релиза; они не переводятся. - Добавление языка = добавить папку словаря + строку в список
SUPPORTED_LOCALES, без изменения кода.
Структура packages/i18n
packages/i18n/
├── locales/
│ ├── ru/ common.json auth.json player.json wave.json collection.json admin.json errors.json
│ └── en/ ...
├── src/
│ ├── index.ts # инициализация i18next, SUPPORTED_LOCALES, детекция
│ └── types.d.ts # типизация ключей (resources → TS), опечатка в ключе = ошибка компиляции
└── scripts/check.ts # проверка: все ключи есть во всех языках, нет лишних, плейсхолдеры совпадают
- Неймспейсы грузятся лениво (веб — по страницам; админка отдельно).
- Плюрализация — ICU / i18next plural (
ru— one / few / many / other): «1 трек», «3 трека», «5 треков». - Даты, длительности, числа —
Intl.*с текущей локалью (Intl.RelativeTimeFormatдля «вчера», группировка истории по дням). - Ошибки API:
errors.jsonсодержит переводы поcodeс подстановкойparams("validation.password_too_short": "Пароль должен быть не короче {{min}} символов"). Неизвестный код → общий текст «Что-то пошло не так» + код в деталях.
Ключи есть в каждом языке, лишних нет, плейсхолдеры совпадают — это проверяет packages/i18n/scripts/check.ts.