Issue33543
Created on 2018-05-16 16:42 by barry, last changed 2022-04-11 14:59 by admin. This issue is now closed.
| Messages (5) | |||
|---|---|---|---|
| msg316838 - (view) | Author: Barry A. Warsaw (barry) *  |
Date: 2018-05-16 16:42 | |
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 |
|||
| msg316841 - (view) | Author: Zachary Ware (zach.ware) * |
Date: 2018-05-16 16:56 | |
Try `make venv && make html`. |
|||
| msg316845 - (view) | Author: Ned Deily (ned.deily) * |
Date: 2018-05-16 17:34 | |
Or just "make venv html". If you already have sphinx installed somewhere, you can just: pip install python-docs-theme |
|||
| msg316849 - (view) | Author: Barry A. Warsaw (barry) * |
Date: 2018-05-16 18:36 | |
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? |
|||
| msg316863 - (view) | Author: Ned Deily (ned.deily) * |
Date: 2018-05-16 20:46 | |
> 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. |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022-04-11 14:59:00 | admin | set | github: 77724 |
| 2018-05-16 20:46:34 | ned.deily | set | messages: + msg316863 |
| 2018-05-16 18:36:58 | barry | set | messages: + msg316849 |
| 2018-05-16 17:34:05 | ned.deily | set | status: open -> closed nosy:
+ ned.deily resolution: works for me |
| 2018-05-16 16:56:16 | zach.ware | set | nosy:
+ zach.ware messages: + msg316841 |
| 2018-05-16 16:42:41 | barry | create | |