[issue33543] `make html` broken
New submission from Barry A. Warsaw <barry@python.org>: Building the documentation in the master (3.8) branch is currently broken: % make html make html mkdir -p build Building NEWS from Misc/NEWS.d with blurb PATH=./venv/bin:$PATH sphinx-build -b html -d build/doctrees -D latex_elements.papersize= . build/html Running Sphinx v1.7.4 loading pickled environment... not yet created Theme error: no theme named 'python_docs_theme' found (missing theme.conf?) make: *** [build] Error 2 ---------- assignee: docs@python components: Documentation messages: 316838 nosy: barry, docs@python priority: normal severity: normal status: open title: `make html` broken versions: Python 3.8 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33543> _______________________________________
Zachary Ware <zachary.ware@gmail.com> added the comment: Try `make venv && make html`. ---------- nosy: +zach.ware _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33543> _______________________________________
Ned Deily <nad@python.org> added the comment: Or just "make venv html". If you already have sphinx installed somewhere, you can just: pip install python-docs-theme ---------- nosy: +ned.deily resolution: -> works for me stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33543> _______________________________________
Barry A. Warsaw <barry@python.org> added the comment: On May 16, 2018, at 13:34, Ned Deily <report@bugs.python.org> wrote:
Or just "make venv html".
Shouldn’t the html target depend on venv then? ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33543> _______________________________________
Ned Deily <nad@python.org> added the comment:
Shouldn’t the html target depend on venv then?
Back when we added support for blurb, I tried to make it such that "make html" could easily use already installed versions of sphinx-build and blurb and not require a venv. I had a particular use case for that. But if someone wants to modify the Docs Makefile to require using the venv recipe, I wouldn't object too strongly. Another approach, I guess, would be to check that the python-docs-theme is available to sphinx-build and give a better message: not sure how best to do that in the current Makefile. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33543> _______________________________________
participants (3)
-
Barry A. Warsaw -
Ned Deily
-
Zachary Ware