Команды CLI
tyndale init
Заголовок раздела «tyndale init»Инициализирует новый проект Tyndale. Создаёт tyndale.config.json с разумными настройками по умолчанию.
npx tyndale inittyndale auth
Заголовок раздела «tyndale auth»Настраивает учётные данные вашего AI-провайдера.
npx tyndale authtyndale translate
Заголовок раздела «tyndale translate»Извлекает строки для перевода и генерирует переводы для всех настроенных локалей.
npx tyndale translate [options]| Флаг | Описание |
|---|---|
--locale <code> | Перевести только указанную локаль |
--force | Повторно перевести все строки, а не только изменения |
--dry-run | Показать, что будет переведено, без записи файлов |
--token-budget <n> | Бюджет токенов на один пакет AI (по умолчанию: 50000) |
--concurrency <n> | Максимальное число параллельных сессий перевода (определяется автоматически) |
tyndale validate
Заголовок раздела «tyndale validate»Проверяет, что все локали содержат полные и корректно сформированные переводы. Вызовы AI не выполняются.
npx tyndale validateЗавершается с кодом 1, если найдены проблемы. Идеально для CI-пайплайнов.
tyndale extract
Заголовок раздела «tyndale extract»Извлекает строки для перевода без их перевода. Полезно для проверки того, что будет отправлено AI-провайдеру.
npx tyndale extracttyndale translate-docs
Заголовок раздела «tyndale translate-docs»Переводит файлы документации (MDX/MD) для любого поддерживаемого фреймворка. Автоматически определяет ваш фреймворк документации или использует конфигурацию из tyndale.config.json.
npx tyndale translate-docs [options]| Флаг | Описание |
|---|---|
--content-dir <path> | Переопределить директорию контента документации |
--force | Повторно перевести всю документацию, а не только отсутствующие файлы |
--concurrency <n> | Максимальное число параллельных сессий перевода (определяется автоматически) |
Поддерживаемые фреймворки: Starlight, Docusaurus, VitePress, MkDocs, Nextra.
translate-docs записывает .tyndale-docs-state.json в корне проекта, чтобы отслеживать хеши исходных документов. Зафиксируйте этот файл в репозитории, чтобы новые клоны могли пропускать неизменённые документы без повторного перевода.
tyndale translate-docs setup
Заголовок раздела «tyndale translate-docs setup»Определяет ваш фреймворк документации и сохраняет конфигурацию в tyndale.config.json.
npx tyndale translate-docs setupСканирует ваш проект на признаки фреймворка (зависимости пакетов и конфигурационные файлы), подтверждает обнаруженный фреймворк и записывает раздел docs в ваш конфиг.
tyndale model
Заголовок раздела «tyndale model»Изменяет AI-модель, используемую для переводов.
npx tyndale model