我正在使用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知道这里发生了什么?谢谢!
答案 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