python-sphinx - 如何在 Sphinx 中为引用链接使用数值而不是脚注？

Question

我正在使用 Sphinx 创建文档我在这里引用标准数字引用方式的论文，例如

file1.rst

bone, extracellular matrix[2], fluids, and diffusing chemicals[3]

references.rst

.. [2] Merks, R. M. H., Newman <MoreText>

.. [3] Turing, A. M. <MoreText>

但它不起作用。我看到数字引用仅用于脚注和引文，您必须使用 documentation 中提到的字母数字文本。 .

我相信很多人都使用带编号的引用文献进行引用。有什么办法可以达到这个目的吗？

Answer 1

可以使用 sphinxcontrib-bibtex Matthias C. M. Troffaes 依赖 BibTex用于存储引文的文件。

安装它(见上面的链接)并添加

extensions = ['sphinxcontrib.bibtex']

到你项目的conf.py文件。

添加带有引用书目的页面

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

“plain”风格是典型的数字引用风格。注意，至于latex的使用，你不要自己把数字填进去。引用是这样完成的

Sphinx is great for documentation :cite:`sphinx_doc_web`

分机将适本地放置号码。