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.
32 lines
2.6 KiB
Markdown
32 lines
2.6 KiB
Markdown
# Локализация
|
||
|
||
## Принципы
|
||
|
||
- Поддерживаемые языки на старте: **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`.
|