翻译文档

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

结构

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

编写配置文件

注册配置文件

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

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

当然,别忘了将上面这行代码的{language-shortuct}部分替换成你所使用语言的ISO 369-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},翻译这个新文件夹下的所有文件(保持文件名不变,只翻译文件内容)。

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