GitBook 內(nèi)容引用

內(nèi)容參考 (conref) 是用來(lái)重復(fù)使用其他文件和書(shū)本內(nèi)容。

導(dǎo)入本地文件

使用 include 標(biāo)簽導(dǎo)入其他文件的內(nèi)容：

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

從其他書(shū)本導(dǎo)入文件

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

真實(shí)的 git url 應(yīng)該以 .git 結(jié)尾，導(dǎo)入的文件名從 .git 之后的 url 片段提取。

commit-ish 可以是任何可以作為 git checkout 參數(shù)的標(biāo)簽，sha，或分支。默認(rèn)是 master。

繼承

模板繼承是一種重復(fù)使用模板的簡(jiǎn)單方式。當(dāng)寫(xiě)完一個(gè)模板，你可以定義 "block" 讓字模板來(lái)替換。繼承鏈可以任意長(zhǎng)。

block 在模板中定義了一個(gè)區(qū)域并用一個(gè)名字標(biāo)識(shí)了它?；?lèi)模板可以指定一些塊，而子類(lèi)可以用新的內(nèi)容替換它們。

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

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

在文件? mypage.md? 中，你應(yīng)該指定用來(lái)替換內(nèi)容的塊。

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

# License

{% import "./LICENSE" %}