跳到主要内容

翻译文档

为了让Axios被尽可能多的人所了解,将文档翻译成多种语言是必要的。我们对想要帮助翻译文档的人表示衷心的感谢。本文给出了向文档添加翻译的指南。

结构

每种语言的翻译都由一个配置文件{language-shortcut}.lang.js(例如,en.lang.js或者de.lang.js),以及一些翻译后的文档文件组成posts/{language-shortcut}/*.md(例如posts/en或者posts/de)。{language-shortcut}应该用你所使用的语言的ISO 639-1双字母代号替换。

编写配置文件

  • 创建一个en.lang.js文件的副本。
  • 将副本重命名为{language-shortcut}.lang.js并对副本文件内容做出以下修改。
  • display字段替换为你所使用的语言的名字,用该种语言的文字来书写。例如,如果你想将文档翻译成德语,应该在该字段填写“Deutsch”而不是“German”。
  • prefix字段替换为/{language-shortcut}/
  • 翻译p字段以及t字段中的values部分,不要翻译keys。
  • 翻译所有sidebar字段里标签为text的属性。**注意:**从文档的当前版本开始,sidebar里的链接部分已经不需要再更新了。

注册配置文件

当你编写完了配置文件后,你需要在项目配置文件里注册该配置。你需要打开inert.config.js文件并且在接近顶部的位置添加下面这一行代码:

const {language-shortcut}Config = require('./{language-shortcut}.config.js');

当然,别忘了将上面这行代码的{language-shortuct}部分替换成你所使用语言的ISO 639-1双字母代号。

现在,找到该文件的langs常量。如果该常量的声明在你的require语句之前,请将你的require语句移至该常量声明之前。对于langs列表,你需要添加如下这个对象:

const langs = [
...
{
name: 'Some name that uniquely identifies your language, for example "English" or "German"',
prefix: "The same prefix as in the configuration file",
config: {language-shortcut}Config // The configuration object you imported earlier
}
...
];

现在,你可以开始翻译文档了。将posts/en文件夹复制到一个新文件夹posts/{language-shortcut},翻译这个新文件夹下的所有文件(保持文件名不变,只翻译文件内容)。

如果你遇到了任何问题,欢迎前来提出问题