Перевод

yfm translate переводит вашу документацию используя Yandex Translator.

Настройка

получите OAUTH-токен как описано в документации yandex.cloud;
положите его в .ya_oauth_token файл внутри домашней директории или укажите с помощью YANDEX_OAUTH_TOKEN переменной окружения;
получите идентификатор каталога, на который у вашего аккаунта есть роль editor или выше, как описано в документации yandex.cloud;
в поле yandexCloudTranslateFolderId внутри .yfm файла конфигурации укажите значение идентификатора из предыдущего пункта;
добавьте поле yandexCloudTranslateGlossaryPairs внутри .yfm файла конфигурации если вам требуется использование glossary-словаря:

# glossary example

yandexCloudTranslateGlossaryPairs:
    - { sourceText: InstreamAdBreakPositionType, translatedText: InstreamAdBreakPositionType }

В результате выполнения InstreamAdBreakPositionType останется без изменения в тексте.

Теперь вы можете использовать yfm для перевода вашей документации.

Название опции	Обязательная или нет	Значение	Описание
--input	да	путь	путь до входной документации
--output	да	путь	путь до выходной документации
--source-language	да	код языка	код языка в формате ISO 639-1
--target-language	да	код языка	код языка в формате ISO 639-1

yfm translate --input input_folder --output output_folder --source-language ru --target-language en

В результате выполнения ваша русская документация из input_folder будет переведена на английский и расположена в output_folder.