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

标签 python python-sphinx bibtex

我正在使用 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 编写器需要修复以更紧密地匹配 html 输出。如果您在 Sphinx 中使用常规引用,也会出现此问题:它与 sphinxcontrib-bibtex 本身无关。

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

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

.. only:: html

  .. rubric:: References

.. bibliography:: refs.bib

关于python - 制作latexpdf文档时的Sphinxcontrib.bibtex问题,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/16776628/

相关文章:

python - 如何在 sphinx doc 中显示实例属性?

python - 制作sphinx autodoc时如何忽略python项目中的 'src'目录

haskell - 如何使用 pandoc 在引用文献中转义 ":"?

latex - 使用Bibtex和hyperref包在URL中进行换行

python - 我怎样才能简化这个 python 迭代?

python - Sphinx add_config_value 不添加变量

python - 在 pandas 合并过程中增加值

bibtex - 将引用的文档作品转换为 bibtex 或尾注格式

python - Django admin 输入错误后出现错误消息

python - 哪个开销更大 : Creating a new socket each time or maintaining a single socket for data transfer