GitBook 內容引用

內容參考 (conref) 是用來重復使用其他文件和書本內容。

導入本地文件

使用 include 標簽導入其他文件的內容：

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

從其他書本導入文件

GitBook 同樣能處理使用了 git 協(xié)議的 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 參數(shù)的標簽，sha，或分支。默認是 master。

繼承

模板繼承是一種重復使用模板的簡單方式。當寫完一個模板，你可以定義 "block" 讓字模板來替換。繼承鏈可以任意長。

block 在模板中定義了一個區(qū)域并用一個名字標識了它?；惸０蹇梢灾付ㄒ恍K，而子類可以用新的內容替換它們。

{% extends "./mypage.md" %}

{% block pageContent %}
# This is my page content
{% endblock %}

在文件? mypage.md? 中，你應該指定用來替換內容的塊。

{% block pageContent %}
This is the default content
{% endblock %}

# License

{% import "./LICENSE" %}