Translate
yfm translate translates your documentation using Yandex Translator
Setup
-
get your OAUTH token as described in yandex.cloud documentation
-
put it inside
.ya_oauth_tokenfile inside home folder or set it withYANDEX_OAUTH_TOKENenvironment variable -
get the ID of any folder that your account is granted the editor role or higher for as described in yandex.cloud documentation
-
set
yandexCloudTranslateFolderIdinside.yfmconfig file to folder id you got from previous step -
set
yandexCloudTranslateGlossaryPairsinside.yfmconfig file if you need to use glossary dictionary while translating (example below)
# glossary example
yandexCloudTranslateGlossaryPairs:
- { sourceText: InstreamAdBreakPositionType, translatedText: InstreamAdBreakPositionType }
This will make InstreamAdBreakPositionType stay without change in the target(translated) document
Now you can use yfm cli to translate your documentation.
Flags
| Option name | required | value | description |
|---|---|---|---|
| --input | yes | path | source path to the documentation |
| --output | yes | path | target path to the translated documentation |
| --source-language | yes | language code | language code in ISO 639-1 format |
| --target-language | yes | language code | language code in ISO 639-1 format |
Usage
yfm translate --input input_folder --output output_folder --source-language ru --target-language en
This will translate your russian documentation in the input_folder into english one putting it to output_folder