Обзор

В этом руководстве показано, как автоматически управлять файлами переводов вашего проекта при использовании gt-next или gt-react.

Мы выполним 4 шага:

Шаг 1: Добавьте переменные окружения

Добавьте свой production API‑ключ и идентификатор проекта в переменные окружения. Это необходимо для работы с инструментом gtx-cli. Вы получите их в панели управления General Translation.

GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>

Шаг 2: Настройте проект с помощью команды npx gtx-cli configure

Выполните команду gtx-cli configure, чтобы настроить проект.

npx gtx-cli configure

Шаг 3: Добавьте команду gtx-cli translate в процесс сборки

Добавьте команду gtx-cli translate в процесс сборки или CI перед командой сборки, чтобы автоматически добавлять переводы в проект.

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <команда сборки>"
  }
}

Это сгенерирует переводы для всех ваших локалей и сохранит их в проекте. Если вы хотите закоммитить эти файлы в репозиторий, вместо этого выполните эту команду перед коммитом.

Готово! Теперь проект будет автоматически обновлять все ваши JSON‑файлы переводов при любых изменениях в проекте.

Примечания

• Вы можете автоматически добавить переводы в свой проект с помощью команды gtx-cli translate.
• Если вы хотите закоммитить файлы переводов, запустите команду gtx-cli translate перед коммитом.
• Чтобы настроить путь для сохранения переводов, см. раздел конфигурация.

Дальнейшие шаги

• См. руководство по использованию инструмента CLI.