mdTranslation

mdTranslation是一个用于准备多语言Markdown文档的工具。

还有一个用于处理mdBook书籍的mdBook预处理器，名为mdbook-translation。

它是如何实现的呢？

这是通过将源内容和它们的翻译关联在一起来实现的。这种关联以特定简单格式中的单独Markdown文档的形式表达。

这个文件看起来是这样的

> Original content 1

* lang_ID1
Translated content written in lang_ID1
* lang_ID2
Translated content written in lang_ID2
****
...

这个库可以读取和比较每个叶节点（段落、列表项等）内的Markdown内容与这里的所有原始内容，如果匹配，它将用相应的翻译内容替换它。这使得在不接触原始文档的情况下进行翻译成为可能。

mdTranslation CLI工具

要使用CLI工具，只需在终端中输入以下内容

cargo install mdtranslation-cli

这允许您使用两个命令

1. mdtranslation_extract

此工具帮助您将原始内容和初始模板提取到Markdown文件中。

例如，如果您想为a.md提供法语翻译，您可以执行以下操作

mdtranslation_extract -l fr_FR a.md >> a.i18n.md

这里的>>允许将新生成的内容追加到文件末尾。您可以使用此方法收集一本书的所有段落。

2. mdtranslation_translate

此工具帮助您为Markdown文件生成翻译和渲染的HTML文件。

例如，如果您想为a.md提供法语翻译，并且您已准备好翻译文件a.i18n.md，您可以执行以下操作

mdtranslation_translate -l fr_FR -t a.i18n.md a.md > a.htm

如果您没有在a.i18n.md中指定语言，您可以在此处传递额外的-d fr_FR参数，告诉程序该语言实际上是fr_FR。这对于单语言翻译情况很有用，尽管我们鼓励您始终为每个段落指定实际的语言。

mdBook-translation预处理器

还有一个mdBook预处理器，允许您将mdTranslation与mdBook一起使用。

• 要安装mdBook预处理器，只需在终端中输入以下内容

cargo install mdbook-translation

• 之后，您可以通过在 book.toml 中添加以下内容为特定书籍启用此预处理器。

[preprocessor.translation]

• 现在，在像往常一样运行 mdbook build 之前，您可以设置环境变量，让预处理器以特定语言生成书籍。

如果您使用的是 Windows cmd.exe，则需要这样做。

set MDTRANSLATION_INPUT=book.i18n.md
set MDTRANSLATION_LANG=fr_FR
set MDTRANSLATION_DEFAULT_LANG=fr_FR

或者如果您使用的是 *nix shell。

export MDTRANSLATION_INPUT=book.i18n.md
export MDTRANSLATION_LANG=fr_FR
export MDTRANSLATION_DEFAULT_LANG=fr_FR

书籍内容将被翻译内容替换。