多语言支持

tags:多语言

前言

gitbook 支持以多种语言来创建和发布同一本书。

具体的介绍可以见官方文档中 “Multi-Languages” 一节的介绍:

http://toolchain.gitbook.com/languages.html

方式

参考上面文档的说明(以下内容为翻译):

多语言支持

gitbook 支持构建用多种语言书写的书籍。每种语言应该是一个子目录,遵循正常的gitbook格式,然后需要在根目录下放置一个名为 LANGS.md 的文件,存放下列内容:

  1. # Languages
  2. * [English](en/)
  3. * [French](fr/)
  4. * [Español](es/)

每种语言的配置

当一个语言的书(如:en)有 book.json 时,它的配置将扩展主要配置。

唯一的一个例外是插件,插件是全局设置的,并且不能指定语言特定的插件。

补充说明

按照 gitbook 的要求,实现多语言是非常简单的。

需要注意的地方是:

  1. 插件的配置必须写在根目录下的 gitbook.json 文件中。然后其他的配置可以分别写在各自语言目录下的 gitbook.json 文件中。
  2. LANGS.md 文件中各个语言出现的顺序,就是书籍首页出现的顺利。因此,写在第一位的语言,就自然成为书籍首页打开时的默认语言。

比较有意义的时,gitbook 官方网站对多语言提供了很多的支持,在书籍首页:

  1. 可以直接选择语言版本,同时自动显示对应语言的 readme.md 的内容
  2. 生成 pdf / mobi 等文件时也是按照各个语言不同生成单独的文件,下载时可以按照语言选择