Машинный перевод

Статья обновлена 1 сентября 2026 г.

Без опции --provider команда yfm translate переводит документацию через Yandex Translate. Это самый быстрый способ перевода: он подходит для черновых версий и регулярной синхронизации языков, но результат обычно требует вычитки. Для более качественного перевода используйте AI-перевод или CAT-системы.

Использование

  1. Получите токен авторизации: OAuth-токен, IAM-токен или API-ключ сервисного аккаунта.

  2. Узнайте идентификатор каталога, для которого у аккаунта есть роль ai.translate.user или выше.

  3. Оцените объем перевода без запросов к API:

    yfm translate -i ./docs --source ru --target en --auth <токен> --folder <идентификатор> --dry-run

  4. Запустите перевод:

    yfm translate -i ./docs --source ru --target en --auth <токен> --folder <идентификатор>

Переведенные файлы появятся в папке целевого языка - в примере выше это docs/en.

Параметры

Общие параметры (--source, --target, --files, --include, --exclude, --dry-run и другие) описаны на странице Локализация. Ниже - параметры провайдера yandex.

Параметр

Описание

--auth

Токен авторизации: значение или путь к файлу с токеном. Тип определяется по префиксу: y0_ - OAuth-токен, t1. - IAM-токен, AQVN - API-ключ сервисного аккаунта. Обязательный

--folder

Идентификатор каталога, для которого у аккаунта есть роль ai.translate.user или выше. Обязательный

--glossary

Путь к YAML-файлу с глоссарием - парами терминов, которые нужно переводить фиксированно

Лимиты

У Yandex Translate есть ограничения на объем переводимого текста. CLI сокращает объем сам: документы разбиваются на сегменты, повторяющиеся сегменты переводятся один раз.

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

Оценить объем текста до запуска помогает опция --dry-run.

Теги

локализация
Предыдущая
Локализация
Следующая
AI-перевод