Skip to main content
 首页 » 编程设计

python之制作latexpdf文档时的Sphinxcontrib.bibtex问题

2024年11月01日8cloudgamer

我正在使用 Sphinx(版本 1.1.3)和 sphinxcontrib.bibtex 为我正在进行的 python 编码项目创建文档。

我在名为 zreferences.rst 的文件中的其余文档中有以下内容

.. rubric:: References 
 
.. bibliography:: refs.bib 
   :cited: 

当使用 make html 构建 html 输出时,这工作正常;然而,当我运行 make latexpdf 时,文档的这一页中没有引用,但它们确实显示在从 latex 模板 Sphinx 自动创建的 引用书目 页面上使用。

我不想有多余的引用页面,所以我尝试删除引用文档,但随后 html 构建停止编译。

有熟悉 Sphinx、LaTeX 和 Bibtex 的人知道这里发生了什么吗?谢谢!

请您参考如下方法:

Sphinx 的 latex writer 需要修复以更紧密地匹配 html 输出。如果您在 Sphinx 中使用常规引用,也会出现此问题:它与 sphinxcontrib-bibtex 本身无关。

sphinxcontrib-bibtex 的用户当然最有可能遇到这个问题。我已经为它创建了一个上游票证:https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/48

目前,此问题的解决方法是仅在生成 html 时创建一个 rubric:

.. only:: html 
 
  .. rubric:: References 
 
.. bibliography:: refs.bib