如何添加参考文献

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

安装和配置

  • book.json中添加如下内容后运行gitbook install:
  1. "plugins": ["bibtex-indexed-cite"],
  2. "bibtex-indexed-cite": {
  3. "path": "/"
  4. }

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

  • 在项目根目录,新增literature.bib和References.md两个文件,其中literature.bib用来存放参考文献数据,References.md文件中写入如下内容:
  1. {% references %} {% endreferences %}

用法

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

  1. {{ "TLW" | cite }}

需要注意,第一、引用名中不能有中文,如{{"GitBook.com-2017"|cite}}不能为{{"中文名称-2017"|cite}};第二、参考文献需要单独用一个文件生成,文件名为“References.md”。

设定参考文献样式

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

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