GitBook 内容引用
内容参考 (conref) 是用来重复使用其他文件和书本内容。
导入本地文件
使用 include 标签导入其他文件的内容:
{% include "./test.md" %}
从其他书本导入文件
GitBook 同样能处理使用了 git 协议的 include 路径:
{% include "git+https://github.com/GitbookIO/documentation.git/README.md#0.0.1" %}
git 的 url 格式是:
git+https://user@hostname/project/blah.git/file#commit-ish
真实的 git url 应该以 .git 结尾,导入的文件名从 .git 之后的 url 片段提取。
commit-ish 可以是任何可以作为 git checkout 参数的标签,sha,或分支。默认是 master。
继承
模板继承是一种重复使用模板的简单方式。当写完一个模板,你可以定义 "block" 让字模板来替换。继承链可以任意长。
block 在模板中定义了一个区域并用一个名字标识了它。基类模板可以指定一些块,而子类可以用新的内容替换它们。
{% extends "./mypage.md" %}
{% block pageContent %}
# This is my page content
{% endblock %}
在文件 mypage.md
中,你应该指定用来替换内容的块。
{% block pageContent %}
This is the default content
{% endblock %}
# License
{% import "./LICENSE" %}