• 内容引用
    • 导入本地文件
    • 从其他书本导入文件
    • 继承

    内容引用

    内容参考 (conref) 是便于用来重复使用其他文件和书本内容。

    导入本地文件

    使用 include 标签导入其他文件的内容真的很简单:

    1. {% include "./test.md" %}

    从其他书本导入文件

    GitBook 同样能处理使用了git协议的include路径:

    1. {% include "git+https://github.com/GitbookIO/documentation.git/README.md#0.0.1" %}

    git的url格式是:

    1. git+https://user@hostname/project/blah.git/file#commit-ish

    真实的git url应该以 .git 结尾,导入的文件名从 .git 之后的url片段提取。

    commit-ish 可以是任何可以作为 git checkout 参数的标签,sha,或分支。默认是 master

    继承

    模板继承是一种重复使用模板的简单方式。当写完一个模板,你可以定义 “block” 让字模板来替换。继承链可以任意长。

    block 在模板中定义了一个区域并用一个名字标识了它。基类模板可以指定一些块,而子类可以用新的内容替换它们。

    1. {% extends "./mypage.md" %}
    2. {% block pageContent %}
    3. # This is my page content
    4. {% endblock %}

    在文件 mypage.md 中,你应该指定用来替换内容的块。

    1. {% block pageContent %}
    2. This is the default content
    3. {% endblock %}
    4. # License
    5. {% import "./LICENSE" %}