search

theochem / AtomDB

An Extended Periodic Table of Neutral and Charged Atomic Species
http://atomdb.qcdevs.org/
GNU General Public License v3.0
16 stars 14 forks source link

Errors while generating documentation with sphinxs #78

Closed gabrielasd closed 6 months ago

gabrielasd commented 6 months ago

I ran into the following problems when trying to generate the sphinx documentation for atomdb with different Python versions.

with Python 3.7.12 After running:

pip install -e .[doc]
cd docs && make html

I get: Running Sphinx v5.3.0 Extension error: Could not import extension sphinx.builders.epub3 (exception: cannot import name 'RemovedInSphinx40Warning' from 'sphinx.deprecation' (MYPATH/miniconda3/envs/qcdevs/lib/python3.7/site-packages/sphinx/deprecation.py)) make: *** [Makefile:20: html] Error 2

with Python 3.9.13: After running: make html

I get: Running Sphinx v5.3.0 Extension error: Could not import extension sphinxcontrib.bibtex (exception: No module named 'sphinxcontrib.bibtex') make: *** [Makefile:20: html] Error 2

For this later case I can get the documentation to compile by commenting the line for sphinxcontrib.bibtex in source/conf.py

gabrielasd commented 6 months ago

This issue was solved by commit c2d5c3186593d0c8f49620bf86d39ef8f2897bf2