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

Question

我正在使用 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 的人知道这里发生了什么吗？谢谢!

Answer 1

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