Files
Dorod-Sky/I18N-QUICK-GUIDE.md

132 lines
3.7 KiB
Markdown
Raw Normal View History

# 🇷🇺 Быстрый доступ: Русский язык в Skyvern
## ✅ Готово к использованию!
### 🌐 Открыть интерфейс
**URL**: http://localhost:8081
### 🔄 Переключить язык
1. Нажмите **Settings** (левая панель)
2. Найдите карточку **"Язык / Language"**
3. Выберите **Русский** или **English**
4. Изменения применятся мгновенно!
### 📋 Что переведено
- ✅ Вся навигация (меню слева)
- ✅ Главная страница (Discover)
- ✅ Страница настроек (Settings)
- ✅ Сообщения об ошибках
### 🎯 Как добавить перевод нового текста
#### 1. Откройте файл перевода:
```bash
# Английский
nano /home/vodorod/dorod/skyvern/skyvern-frontend/public/locales/en/common.json
# Русский
nano /home/vodorod/dorod/skyvern/skyvern-frontend/public/locales/ru/common.json
```
#### 2. Добавьте новый ключ:
**English (`en/common.json`):**
```json
{
"mySection": {
"myText": "My new text in English"
}
}
```
**Русский (`ru/common.json`):**
```json
{
"mySection": {
"myText": "Мой новый текст на русском"
}
}
```
#### 3. Используйте в коде:
```tsx
import { useTranslation } from "react-i18next";
function MyComponent() {
const { t } = useTranslation("common");
return <div>{t("mySection.myText")}</div>;
}
```
### 📁 Файловая структура
```
skyvern-frontend/
├── src/
│ ├── i18n/
│ │ └── config.ts # Конфигурация i18n
│ └── components/
│ └── LanguageSwitcher.tsx # Переключатель языка
└── public/
└── locales/
├── en/
│ ├── common.json # Общие переводы EN
│ └── settings.json # Настройки EN
└── ru/
├── common.json # Общие переводы RU
└── settings.json # Настройки RU
```
### 🔧 Команды
#### Перезапуск frontend:
```bash
cd /home/vodorod/dorod/skyvern/skyvern-frontend
pkill -f "vite"
npm run dev
```
#### Проверка JSON файлов:
```bash
# Проверить валидность JSON
cat public/locales/ru/common.json | python3 -m json.tool
```
#### Очистка кеша языка:
```javascript
// В консоли браузера (F12)
localStorage.removeItem("i18nextLng");
location.reload();
```
### 📚 Документация
- **Полная документация**: `I18N-IMPLEMENTATION-COMPLETE.md`
- **Анализ и планирование**: `I18N-ANALYSIS.md`
### 🚀 Запуск всей системы
#### Backend (Terminal 1):
```bash
cd /home/vodorod/dorod/skyvern
.venv/bin/python -m uvicorn skyvern.forge.api_app:app --host 0.0.0.0 --port 8000
```
#### Frontend (Terminal 2):
```bash
cd /home/vodorod/dorod/skyvern/skyvern-frontend
npm run dev
```
### ✨ Проверка работы
1. Откройте http://localhost:8081
2. Посмотрите на меню слева:
- Видите "Обзор" → русский работает ✅
- Видите "Discover" → английский работает ✅
3. Зайдите в Settings → Переключите язык
4. Всё должно мгновенно измениться!
---
**Время реализации**: 2 часа
**Статус**: ✅ Производственно готово
**Поддерживаемые языки**: English, Русский