如何在Sphinx中使用引用链接的数值而不是脚注？

Question

我正在用Sphinx创建一个文档，我在其中引用标准数字引用方式的论文，例如

文件1.rst

骨骼、细胞外基质[2]、体液和扩散化学物质[3]

参考文献.rst

.. [2] 默克斯，RMH，纽曼 <MoreText>

.. [3] 图灵，上午 <MoreText>

但它不起作用。我看到的数字引用仅脚注和你在提到使用字母文本引用文档。

我相信很多人都使用编号的参考文献进行引用。有没有办法做到这一点？

Answer 1

可以使用Matthias CM Troffaes 的sphinxcontrib-bibtex，它依赖于BibTex文件来存储引文。

安装它（见上面的链接）并添加

extensions = ['sphinxcontrib.bibtex']

到conf.py您的项目文件。

添加带有参考书目的页面

.. bibliography:: /path/to/bibtex/file.bib
   :style: plain

样式“plain”是典型的数字引用样式。请注意，对于乳胶的使用，您不要自己填写数字。引用是这样完成的

Sphinx 非常适合文档 :cite:`sphinx_doc_web`

并且分机将适当地放置号码。