У меня возникла странная ошибка при создании нашей документации с использованием 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.
Sphinxcontrib-bibtex и сфинкс-мультиверсия ⇐ Python
Программы на Python
-
Anonymous
1778613390
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.
[b]Но[/b], если я использую цитату в строке документации 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.
Ответить
1 сообщение
• Страница 1 из 1
Перейти
- Кемерово-IT
- ↳ Javascript
- ↳ C#
- ↳ JAVA
- ↳ Elasticsearch aggregation
- ↳ Python
- ↳ Php
- ↳ Android
- ↳ Html
- ↳ Jquery
- ↳ C++
- ↳ IOS
- ↳ CSS
- ↳ Excel
- ↳ Linux
- ↳ Apache
- ↳ MySql
- Детский мир
- Для души
- ↳ Музыкальные инструменты даром
- ↳ Печатная продукция даром
- Внешняя красота и здоровье
- ↳ Одежда и обувь для взрослых даром
- ↳ Товары для здоровья
- ↳ Физкультура и спорт
- Техника - даром!
- ↳ Автомобилистам
- ↳ Компьютерная техника
- ↳ Плиты: газовые и электрические
- ↳ Холодильники
- ↳ Стиральные машины
- ↳ Телевизоры
- ↳ Телефоны, смартфоны, плашеты
- ↳ Швейные машинки
- ↳ Прочая электроника и техника
- ↳ Фототехника
- Ремонт и интерьер
- ↳ Стройматериалы, инструмент
- ↳ Мебель и предметы интерьера даром
- ↳ Cантехника
- Другие темы
- ↳ Разное даром
- ↳ Давай меняться!
- ↳ Отдам\возьму за копеечку
- ↳ Работа и подработка в Кемерове
- ↳ Давай с тобой поговорим...
Мобильная версия