Locadex для Next.js App Router

Автоматизируйте перевод вашего приложения Next.js

Перевод вашего приложения Next.js на французский 🇫🇷, испанский 🇪🇸, японский 🇯🇵 или любой другой язык — долгий и трудозатратный процесс.

Locadex — это AI‑агент, который берет на себя 100% работ по интернационализации (i18n). Установка занимает 5 минут.

Экран установки Locadex

Locadex:

  • Настраивает ваш проект для использования библиотеки i18n gt-next
  • Вносит изменения в ваши React‑компоненты и строки, чтобы поддерживать мультиязычный контент
  • Переводит ваше приложение на столько языков, сколько вам нужно
  • Непрерывно выполняет интернационализацию и перевод по мере публикации нового контента

Настройка

Шаг 1: Войдите в панель управления General Translation

Перейдите в свою панель управления и выполните вход в аккаунт.

Шаг 2: Подключите GitHub

  1. Перейдите в раздел интеграции с GitHub в панели управления
  2. Нажмите «Connect GitHub», чтобы привязать свой аккаунт GitHub
  3. Вы будете перенаправлены на GitHub для подтверждения доступа

Шаг 3: Установите приложение GitHub

  1. После подключения GitHub вы будете перенаправлены на установку приложения Locadex для GitHub
  2. Выберите, к каким репозиториям предоставить доступ Locadex:
    • Установить для всех репозиториев, или
    • Выбрать конкретные репозитории
  3. Нажмите «Install», чтобы завершить установку приложения GitHub

Шаг 4: Привяжите репозиторий к проекту

  1. Вернитесь в консоль GT и выберите репозиторий, который хотите локализовать
  2. Это свяжет ваш репозиторий с настройками перевода и целевыми языками
  3. К одному проекту можно привязать только один репозиторий, но вы можете создать несколько проектов, каждый со своим репозиторием

Шаг 5: Настройка

На экране конфигурации задайте:

  • Целевые языки: Выберите локали, на которые будет выполняться перевод

Экран установки Locadex

Шаг 6: Завершение установки

  1. Проверьте параметры конфигурации
  2. Нажмите «Install», чтобы активировать Locadex для вашего репозитория
  3. Вы перейдёте на обзорную страницу, где будет показан подключённый репозиторий GitHub

Что дальше

Первоначальная настройка

После завершения установки:

  1. Мгновенное создание PR: Locadex создаст pull request в вашей основной ветке
  2. Полная настройка: Этот PR запускает полную команду настройки Locadex, которая:
    • Устанавливает библиотеки GT
    • Настраивает проект для интернационализации
    • Разворачивает инфраструктуру перевода
  3. Проверка и слияние: Проверьте PR и слейте его, чтобы завершить настройку i18n

Непрерывная интернационализация

После объединения первоначальной настройки:

  1. Locadex отслеживает вашу основную или указанную ветку на наличие pull request’ов
  2. Когда вы отправляете новый код с переводимым содержимым, дождитесь, пока Locadex добавит свой коммит в PR
  3. Как только Locadex добавит коммит в PR, можно безопасно объединять — ваш новый код интернационализирован
  4. Ваше приложение остается переведенным без ручного вмешательства

Мониторинг репозитория

Панель подключения Locadex к GitHub

Панель настроек Locadex

Статус дашборда

В дашборде вы можете отслеживать:

  • Состояние репозитория: Индикатор активного мониторинга
  • Конфигурация: Текущие настройки и целевые языки

Интеграция с GitHub

  • Проверки статуса: Locadex добавляет обновления статуса к pull request’ам
  • Запуски проверок: GitHub показывает статус обработки в Locadex

Диагностика и устранение неполадок

Частые проблемы

Locadex не создаёт PR

  • Убедитесь, что GitHub‑приложение имеет доступ к репозиторию
  • Проверьте, что в коммитах есть переводимое содержимое

Нужны изменения конфигурации

  • Обновите настройки веток в панели управления GT
  • Изменения вступят в силу для новых коммитов после обновления

Поддерживаемые фреймворки

На данный момент Locadex поддерживает только приложения Next.js с App Router.

Насколько полезно это руководство?

Locadex для Next.js App Router