Автоматический перевод
Как автоматически перевести проект с помощью инструмента командной строки General Translation (CLI)
npx gtx-cli@latestОбзор
Инструмент командной строки General Translation (gtx-cli) позволяет автоматически переводить ваш проект на любой из поддерживаемых языков.
Он обеспечивает полную поддержку gt-next и gt-react в вашем проекте, позволяя сканировать проект на наличие переводимого контента, переводить его и генерировать JSON-файлы с данными переводов.
Инструмент CLI также можно использовать для генерации переводов для сторонних библиотек i18n, таких как next-intl или i18next.
Кроме того, инструмент CLI можно использовать для перевода JSON, Markdown, MDX, JS и TS файлов.
Для команды translate требуется Production API-ключ. Получите его бесплатно на generaltranslation.com!
Есть две основные команды, которые вам нужно знать: init и translate.
- Команда
initиспользуется для настройки вашего проекта. Она предоставляет пошаговый мастер настройки, который подготовит ваш проект для интернационализации, включая:
- Настройку плагинов и React-провайдеров
- Генерацию API-ключей
- Настройку локалей и структуры файлов вашего проекта
- Команда
translateпредназначена для добавления в ваш CI/CD-пайплайн. Она используется для сканирования вашего проекта на наличие контента для перевода. Затем контент загружается в CDN или добавляется в бандл вашего приложения для использования во время выполнения.
Быстрый старт
В зависимости от используемой в проекте библиотеки i18n следуйте одному из этих руководств:
Использование
| Команда | Описание |
|---|---|
npx gtx-cli init | Запускает мастер настройки GT. |
npx gtx-cli configure | Настраивает параметры GT для вашего проекта. |
npx gtx-cli translate | Переводит проект через GT API. |
npx gtx-cli auth | Генерирует ключ API и идентификатор проекта для вашего проекта. |
npx gtx-cli generate | Создаёт новый JSON‑файл с данными переводов. Используйте при автономном применении библиотеки. |
Насколько полезно это руководство?