codecamp

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" %}


GitBook 模板
GitBook 忽略文件和文件夹
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }