English | 繁體中文 | Deutsch | 日本語 | русский | 한국어 | Português | Español | Français | हिन्दी
Free Markdown Translator是一款基于 Translators 的免费、开源的Markdown文档翻译器,能够将你的Markdown文档翻译成多种语言。
功能:
本程序参考如何使用translate.google.cn免費Google翻譯網站翻譯整篇Markdown文檔, V2修改版 (knightli.com)
注意,若使用谷歌翻译等未在中国大陆提供服务的翻译引擎,在中国大陆等地区可能需要配置代理方能正常使用。
可执行程序使用同一目录下的config.yaml
文件作为配置文件,当config.yaml
缺失时,使用默认配置,配置详情参考配置
小节的内容。
usage: MarkdownTranslator.exe [-h] [-f file/folder [file/folder ...]]
Markdown translator, which translates markdown documents to target languages
you want.
options:
-h, --help show this help message and exit
-f file/folder [file/folder ...]
the markdown documents or folders to translate.
参数位置放置待翻译的文件或文件夹,可以添加多个文件夹,程序会自动按顺序翻译每个文件夹下的每个在配置文件中指定的文件。
例如,若指定的目标语言为英语(en)、日本语(ja),则readme.md
文件会被翻译到同文件夹下的readme.en.md
,readme.ja.md
。
请在与可执行程序使用同一目录下的config.yaml
中进行配置,有关yaml
文本格式的说明可以参考:What is YAML?
insert_warnings
: 控制是否在文档前面添加由机器翻译的警告src_language
: 指定源语言,auto表示由谷歌自动识别target_langs
: 需要翻译的目标语言translator
: 使用的翻译引擎,支持google, bing, alibaba, sogou, youdao, tencent, baidu等翻译引擎src_filenames
: 文件目录下需要自动检测并翻译的Markdown文档的名称threads
: 翻译时使用的最大线程数proxy
: 配置代理warnings_mapping
: 对应语言的由机器翻译警告的具体内容compact_langs
:紧凑型语言,解决英语等非紧凑型语言的分隔问题front_matter_transparent_keys
: markdown的Front Matter中不用翻译的部分front_matter_key_value_keys
: Front Matter中需要以Key-Value形式翻译的部分front_matter_key_value_array_keys
: Front Matter中以Key-Value-Arrays形式翻译示例配置文件:
# 控制是否在文章前面添加机器翻译的Warning
insert_warnings: true
# 源语言,auto表示自动识别
src_language: auto
# 目标语言
target_langs:
- zh
- en
- ja
- ru
# 使用的翻译引擎,支持google, bing, alibaba, sogou, youdao, tencent, baidu等翻译引擎
translator: google
# 文件目录下需要翻译的文档的名称
src_filenames:
- 'index'
- 'README'
- '_index'
# 翻译时使用的最大线程数,不超过30,小于等于0表示使用默认线程数
threads: -1
# 配置代理
proxy:
# 是否启用代理
enable: false
# 代理地址
address: 127.0.0.1
# 代理端口
port: 1234
# 代理用户名和密码
username:
password:
# 配置目标语言及其warning,默认按照定义顺序翻译为下面语言
warnings_mapping:
zh: "警告:本文由机器翻译生成,可能导致质量不佳或信息有误,请谨慎阅读!"
zh-TW: "警告:本文由機器翻譯生成,可能導致質量不佳或信息有誤,請謹慎閱讀!"
en: "Warning: This page is translated by MACHINE, which may lead to POOR QUALITY or INCORRECT INFORMATION, please read with CAUTION!"
ja: "警告: この記事は機械翻訳されているため、品質が低かったり不正確な情報が含まれる可能性があります。よくお読みください。"
ru: "Предупреждение: Эта статья переведена автоматически, что может привести к некачественной или неверной информации, пожалуйста, внимательно прочитайте!"
es: "Advertencia: este artículo está traducido por una máquina, lo que puede dar lugar a una mala calidad o información incorrecta. ¡Lea atentamente!"
fr: "Attention : cet article est traduit par machine, ce qui peut entraîner une mauvaise qualité ou des informations incorrectes, veuillez lire attentivement !"
de: "Achtung: Dieser Artikel wurde maschinell übersetzt, was zu schlechter Qualität oder falschen Informationen führen kann, bitte sorgfältig lesen!"
# # 印地语
hi: 'चेतावनी: यह लेख मशीन द्वारा अनुवादित है, जिससे खराब गुणवत्ता या गलत जानकारी हो सकती है, कृपया ध्यान से पढ़ें!'
# 葡萄牙语
pt: 'Aviso: Este artigo é traduzido por máquina, o que pode levar a má qualidade ou informações incorretas, leia com atenção!'
# 韩语
ko: '경고: 이 기사는 기계 번역으로 생성되어 품질이 좋지 않거나 잘못된 정보로 이어질 수 있으므로 주의 깊게 읽으십시오!'
# 紧凑型语言,解决英语等非紧凑型语言的分隔问题
compact_langs:
- zh-TW
- ja
# markdown中Front Matter不用翻译的部分
front_matter_transparent_keys:
- 'date:'
- 'slug:'
- 'toc'
- 'image'
- 'comments'
- 'readingTime'
- 'menu:'
- ' main:'
- ' weight:'
- ' params:'
- ' icon:'
- 'links:'
- ' website:'
- ' image:'
- 'layout:'
- 'outputs:'
- ' - html'
- ' - json'
- 'license:'
- '#'
- 'style:'
- ' background:'
- ' color:'
# Front Matter中需要以Key-Value形式翻译的部分
front_matter_key_value_keys:
- 'title:'
- 'description:'
- ' name:'
- ' - title:'
- ' description:'
# Front Matter中以Key-Value—Arrays形式翻译
front_matter_key_value_array_keys:
- 'tags:'
- 'categories:'
- 'keywords:'
目标语言需要使用ISO 639-1语言代码,具体可以参考List of ISO 639-1 codes - Wikipedia,下面给出一些常用的语言代码
语言名称 | 该语言自称 | 语言代码 |
---|---|---|
Chinese | 漢語、汉语、华语 | zh |
English | English | en |
Japanese | 日本語 | ja |
Spanish | Español | es |
Russian | русский | ru |
French | français | fr |
German | Deutsch | de |
Arabic | العربية | ar |
Hindi | हिन्दी | hi |
Portuguese | Português | pt |
Korean | 한국어/韓國語, 朝鮮말/조선말 | ko |