如何添加参考文献
GitBook 项目创建时间不长,有些功能可能还没有插件,或者有些插件的功能并不完善,比如参考文献的插件。GitBook 有多个使用 bibtex 生成参考文献的格式,多数很少更新,且功能过于简单。
1. 安装和配置
首先,在 book.json
中添加如下内容后运行 $ gitbook install
:
"plugins": ["bibtex-indexed-cite"],
"bibtex-indexed-cite": {
"path": "/"
}
其中 path
用来指定参考文献库 literature.bib
所在的路径。
然后,在项目根目录,新增 literature.bib
和 References.md
两个文件,其中 literature.bib
用来存放参考文献数据, References.md
文件中写入如下内容:
{% references %} {% endreferences %}
2. 用法
在需要引用参考文献的地方使用如下命令:{{"<gitbook.com>-2017"|cite}}
{{ "TLW" | cite }}
需要注意:
引用名中不能有中文,如
[Citation not found]
不能为[Citation not found]
参考文献需要单独用一个文件生成,文件名为
References.md
。
3. 设定参考文献样式
bibtex-indexed-cite
插件,目前只支持 IEEE 的引文格式,且引用没有上标,可通过自定义样式表实现上标效果:
a[href*="#cite"] {
vertical-align: super;
font-size: 0.8em;
}