如何添加参考文献

GitBook 项目创建时间不长,有些功能可能还没有插件,或者有些插件的功能并不完善,比如参考文献的插件。GitBook 有多个使用 bibtex 生成参考文献的格式,多数很少更新,且功能过于简单。

1. 安装和配置

首先,在 book.json 中添加如下内容后运行 $ gitbook install

"plugins": ["bibtex-indexed-cite"],

"bibtex-indexed-cite": {
    "path": "/"
}

其中 path 用来指定参考文献库 literature.bib 所在的路径。

然后,在项目根目录,新增 literature.bibReferences.md 两个文件,其中 literature.bib 用来存放参考文献数据, References.md 文件中写入如下内容:

{% references %} {% endreferences %}

2. 用法

在需要引用参考文献的地方使用如下命令:{{"<gitbook.com>-2017"|cite}}

{{ "TLW" | cite }}

需要注意:

  1. 引用名中不能有中文,如 [Citation not found] 不能为 [Citation not found]

  2. 参考文献需要单独用一个文件生成,文件名为 References.md

3. 设定参考文献样式

bibtex-indexed-cite 插件,目前只支持 IEEE 的引文格式,且引用没有上标,可通过自定义样式表实现上标效果:

a[href*="#cite"] {
    vertical-align: super;
    font-size: 0.8em;
}

results matching ""

    No results matching ""