Добавление языков

Обновлено: в прошлом квартале · 1 мин чтения

Устаревшее

Эта документация охватывает устаревший CLI (v0). Актуальная версия — CLI v1. Перейти к актуальной документации CLI

Добавьте новые целевые языки: обновите массив targets в i18n.json и запустите CLI. Для новых локалей CLI сгенерирует полные файлы переводов, а существующие переводы останутся без изменений.

Добавить язык#

Обновите Конфигурацию i18n.json:

json
{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  }
}

Запустите CLI:

bash
npx lingo.dev@latest run

CLI создаст полные файлы переводов для каждой новой локали:

text
locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

Существующие и новые языки#

CLI по-разному работает с существующими и новыми языками:

Существующие языкиНовые языки
ПоведениеПереводятся только отсутствующие ключиПолные файлы генерируются с нуля
Существующий контентСохраняетсяН/Д

Региональные варианты#

CLI поддерживает региональные варианты языков с использованием тегов BCP 47:

json
{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

Для каждого варианта создаётся отдельный файл перевода с терминологией, орфографией и тоном, подходящими для региона.

Точечная генерация#

Сгенерируйте переводы для конкретного языка, не обрабатывая все targets:

bash
npx lingo.dev@latest run --target-locale de

Это удобно, если вы добавляете языки по одному, чтобы проверить качество перед дальнейшим масштабированием.

Удаление языков#

Удалите локаль из массива targets, и CLI перестанет её обрабатывать. Существующие файлы не удаляются — при необходимости удалите их вручную.

Что дальше#