Проблемы с Sphinxcontrib.bibtex при создании документа latexpdf

Question

Я использую Sphinx (версия 1.1.3) & sphinxcontrib.bibtex для создания документа для проекта кодирования питона, который я выполняю.

У меня есть следующие в отдельном файле от остальных моих документов в файле с именем zreferences.rst

.. rubric:: References 

.. bibliography:: refs.bib 
    :cited: 

Это прекрасно работает при создании вывода HTML с make html; однако, когда я запускаю make latexpdf, ссылки отсутствуют на этой странице документа, но они отображаются на странице Библиография, которая автоматически создается из латексного шаблона, используемого Sphinx.

Я не хочу иметь страницу избыточных ссылок, поэтому я попытался удалить документ с ссылками, но тогда сборка html перестает компилироваться.

Есть ли знакомые с Sphinx, LaTeX и Bibtex, которые знают, что здесь происходит? Благодаря!

Answer 1

Латексный писатель Sphinx нуждается в фиксации, чтобы ближе соответствовать выходу html. Эта проблема также возникнет, если вы используете регулярные цитаты в Sphinx: она не имеет ничего общего с sphinxcontrib-bibtex как таковой.

Пользователи sphinxcontrib-bibtex, конечно, наиболее вероятно, столкнутся с этой проблемой. Я создал вверх по течению билета на него: https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/48

В настоящем время, обходной путем для этой проблемы является создание рубрики только тогда, когда HTML генерируются:

.. only:: html 

    .. rubric:: References 

.. bibliography:: refs.bib