多语言支持

tags:多语言

前言

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

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

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

方式

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

多语言支持

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

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

每种语言的配置

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

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

补充说明

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

需要注意的地方是：

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

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

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