Обзор

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

Мы пройдём 4 шага:

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

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

GT_API_KEY=<ваш-api-ключ>
GT_PROJECT_ID=<ваш-id-проекта>

Шаг 2: Установите gtx-cli

Установите инструмент gtx-cli в свой проект.

npm i gtx-cli

yarn add --dev gtx-cli

bun add --dev gtx-cli

pnpm add --save-dev gtx-cli

Шаг 3: Создайте файл gt.config.json

Создайте файл gt.config.json в корне вашего проекта.

{
  "defaultLocale": "ru",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["i18n/[locale]/*.json"]
    },
  },
}

При необходимости настройте файл gt.config.json под свои задачи. Дополнительные сведения см. в документации по конфигурации.

Обновите формат файла json, чтобы путь в include соответствовал структуре вашего проекта.

Шаг 4: Добавьте команду 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.