1. 模板

这是 GitBook 可使用的模板特性的简要概述。GitBook 使用 Nunjucks 和 Jinja2 的语法。

1.1. 转义

如果你想要输出任何特殊的目标标签，你可以使用raw，任何在其中的内容都会原样输出。

{% raw %}
  这 {{ 不会被处理 }}
{% endraw %}

变量会从书本内容中寻找对应的值。

变量被定义在 book.json 文件中：

{
    "variables": {
        "myVariable": "Hello World"
    }
}

定义在 book.json 中的变量可以在 book 作用域下被访问：

这会从书本的变量中寻找 myVariable 并显示它。变量的名字可以存在点 (dot) 来查找属性。你同样可以使用方括号语法。
如果对应的值没有定义，那么什么也不会显示。下面这些语句不会输出任何东西，如果 foo 没有定义的话：{{ book.foo }}，{{ book.foo.far }}，{{ book.foo.bar.baz }}。

一些变量也可以用来获取当前文件或GitBook实例的信息。

Name	Description
`file.path`	Path of the file relative to the book
`file.mtime`	Last modified date of the file

标签是在章节和模板中执行操作的特殊块

if 测试一个条件并让你选择性的显示内容。它的行为的和编程语言中的 if 一样。

如果 variable 被定义了并且是真的，那么 "It is true" 就会被显示出来。否则，没有任何东西会被显示。

你可以使用elif和else来指定选择性条件：

I am good!

for 迭代数组和字典。

让我们来看一下 book.json 中的变量：

{ "variables": { "authors": [ { "name": "Samy" }, { "name": "Aaron" } ] } }

上面的例子使用 authors 数组的每项的 name 属性作为显示的值，列出了所有的作者 (author) 。

Include 的详细描述在文章内容引用中。