• 如何添加参考文献
    • 安装和配置
    • 用法
    • 设定参考文献样式

    如何添加参考文献

    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. }