89 lines
4.9 KiB
Markdown
89 lines
4.9 KiB
Markdown
|
# Обновление: Добавлена система локализации
|
|||
|
|
|
|||
|
|
## Что изменилось
|
|||
|
|
|
|||
|
|
### 1. Создана папка `lang` с файлами локализации
|
|||
|
|
- `en.json` — английский язык
|
|||
|
|
- `ru.json` — русский язык
|
|||
|
|
- `kz.json` — казахский язык (пример)
|
|||
|
|
- `README.md` — инструкция по добавлению новых языков
|
|||
|
|
|
|||
|
|
### 2. Изменения в `main.py`
|
|||
|
|
|
|||
|
|
#### Бэкенд:
|
|||
|
|
- Добавлена константа `LANG_DIR` для папки с локализациями
|
|||
|
|
- Добавлена функция `get_available_languages()` — сканирует папку lang и возвращает список доступных языков
|
|||
|
|
- Добавлена функция `load_language(lang_code)` — загружает файл локализации
|
|||
|
|
- Добавлен эндпоинт `GET /api/languages` — возвращает список доступных языков
|
|||
|
|
- Добавлен эндпоинт `GET /api/language/{lang_code}` — возвращает строки локализации для языка
|
|||
|
|
- В `config.json` добавлено поле `language` (по умолчанию "ru")
|
|||
|
|
- Обновлена модель `SettingsModel` с полем `language`
|
|||
|
|
|
|||
|
|
#### Фронтенд:
|
|||
|
|
- Добавлены реактивные переменные:
|
|||
|
|
- `availableLanguages` — список доступных языков
|
|||
|
|
- `translations` — текущие строки локализации
|
|||
|
|
- `currentLang` — текущий выбранный язык
|
|||
|
|
- Добавлена функция `t(key, params)` — возвращает локализованную строку с подстановкой параметров
|
|||
|
|
- Добавлена функция `loadLanguage(langCode)` — загружает локализацию
|
|||
|
|
- Добавлена функция `changeLanguage(langCode)` — меняет язык интерфейса
|
|||
|
|
- Все текстовые строки в интерфейсе заменены на вызовы `t('ключ')`
|
|||
|
|
- В настройках добавлен селектор языка интерфейса
|
|||
|
|
- При загрузке приложения автоматически загружается язык из настроек
|
|||
|
|
|
|||
|
|
### 3. Изменения в `config.json`
|
|||
|
|
Теперь файл содержит дополнительное поле:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"readeck_url": "...",
|
|||
|
|
"readeck_token": "...",
|
|||
|
|
"public_host": "...",
|
|||
|
|
"language": "ru"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Как использовать
|
|||
|
|
|
|||
|
|
### Смена языка интерфейса
|
|||
|
|
1. Откройте настройки (кнопка ⚙️)
|
|||
|
|
2. Выберите язык в выпадающем списке "🌍 Язык интерфейса"
|
|||
|
|
3. Интерфейс сразу переключится на выбранный язык
|
|||
|
|
4. Нажмите "Сохранить" чтобы сохранить выбор
|
|||
|
|
|
|||
|
|
### Добавление нового языка
|
|||
|
|
1. Создайте файл `lang/код_языка.json` (например, `de.json` для немецкого)
|
|||
|
|
2. Скопируйте структуру из `en.json` или `ru.json`
|
|||
|
|
3. Переведите все значения (не меняя ключи)
|
|||
|
|
4. Укажите `lang_name` и `lang_code`
|
|||
|
|
5. Перезапустите приложение
|
|||
|
|
6. Новый язык автоматически появится в настройках!
|
|||
|
|
|
|||
|
|
## Пример файла локализации
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"lang_name": "Deutsch",
|
|||
|
|
"lang_code": "de",
|
|||
|
|
"app_title": "Readeck Importer",
|
|||
|
|
"app_subtitle": "Lokale Artikel mit Übersetzung in Readeck importieren",
|
|||
|
|
"settings": "Einstellungen",
|
|||
|
|
...
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Технические детали
|
|||
|
|
|
|||
|
|
- Локализация загружается асинхронно при старте приложения
|
|||
|
|
- Язык сохраняется в `config.json` и восстанавливается при следующем запуске
|
|||
|
|
- Система поддерживает параметры в строках: `{id}`, `{words}`, `{error}` и т.д.
|
|||
|
|
- Если файл локализации не найден, используются ключи как fallback
|
|||
|
|
- Все файлы должны быть в кодировке UTF-8
|
|||
|
|
|
|||
|
|
## Преимущества реализации
|
|||
|
|
|
|||
|
|
✅ **Простота добавления языков** — просто положите JSON-файл в папку `lang`
|
|||
|
|
✅ **Автоматическое обнаружение** — новые языки появляются в интерфейсе без изменения кода
|
|||
|
|
✅ **Горячая замена** — язык меняется мгновенно без перезагрузки страницы
|
|||
|
|
✅ **Расширяемость** — легко добавить любое количество языков
|
|||
|
|
✅ **Централизация** — все переводы в одном месте
|