Sphinxcontrib-bibtex и сфинкс-мультиверсияPython

Программы на Python
Ответить
Anonymous
 Sphinxcontrib-bibtex и сфинкс-мультиверсия

Сообщение Anonymous »

У меня возникла странная ошибка при создании нашей документации с использованием sphinxcontrib-bibtex и sphinx-multiversion.
В моем docs/source/conf.py у меня есть
from pathlib import Path

extensions = [
"sphinx_multiversion",
"sphinxcontrib.bibtex",
]

# Get the directory where conf.py is located
CONF_DIR = Path(__file__).parent

bibtex_bibfiles = [str(CONF_DIR / "literature.bib")]

В том же каталоге у меня находится файл литература.bib.
Если я использую цитату в первых файлах, все работает при использовании
sphinx-build -W --keep-going -n source build/html и при использовании
sphinx-multiversion -W --keep-going -n source build/html.
Но, если я использую цитату в строке документации Python, работает только команда sphinx-build.
Есть ли у кого-нибудь решение для этой проблемы?

Чтобы добавить дополнительную информацию:
Что-то вроде
The whole software package was published in :cite:`cho_quemb_2025`.

в файле index.rst работает.
Но
"""
...
If you use :python:`"chemgen"` in your work
please credit :cite:`weser_automated_2023`.
"""

в строке документации происходит сбой и выдается
/home/mcocdawc/code/quemb/src/quemb/molbe/fragment.py:docstring of quemb.molbe.fragment.fragmentate:19: WARNING: could not find bibtex key "weser_automated_2023" [bibtex.key_not_found]

Обратите внимание: ключ цитирования существует в файле bib, и ошибка также сохраняется, если я использую ключ цитирования, который используется в файле RST (и работает там).
Фактический код можно найти здесь.
Ошибку можно воспроизвести через
git clone git@github.com:troyvvgroup/quemb.git
cd quemb
git checkout improve_doc
pip install .
cd docs
pip install -r requirements.txt # additional requirements for docs

make html # works
sphinx-build -W --keep-going -n source build/html # works
sphinx-multiversion -W --keep-going -n source build/html # fails with the given error message.
Ответить

Быстрый ответ

Изменение регистра текста: 
Смайлики
:) :( :oops: :roll: :wink: :muza: :clever: :sorry: :angel: :read: *x)
Ещё смайлики…
   
К этому ответу прикреплено по крайней мере одно вложение.

Если вы не хотите добавлять вложения, оставьте поля пустыми.

Максимально разрешённый размер вложения: 15 МБ.

Вернуться в «Python»