制作latexpdf文件时出现Sphinxcontrib.bibtex问题

时间:2013-05-27 15:48:13

标签: python python-sphinx bibtex

我正在使用Sphinx(版本1.1.3)& sphinxcontrib.bibtex为我正在做的python编码项目创建一个文档。

我在名为 zreferences.rst

的文件中的其他文档的单独文件中有以下内容
.. rubric:: References

.. bibliography:: refs.bib
   :cited:

使用make html构建html输出时,此方法正常;但是,当我运行make latexpdf时,文档的此页面中不存在引用,但它们确实显示在 Bibliography 页面上,该页面是从Sphinx使用的乳胶模板自动创建的。

我不想拥有冗余引用页面,所以我尝试删除引用文档,但是html构建停止编译。

是否有人熟悉Sphinx,LaTeX和Bibtex知道这里发生了什么?谢谢!

1 个答案:

答案 0 :(得分:2)

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

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

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

.. only:: html

  .. rubric:: References

.. bibliography:: refs.bib