search

django / djangoproject.com

Source code to djangoproject.com
https://www.djangoproject.com/
BSD 3-Clause "New" or "Revised" License
1.86k stars 937 forks source link

./manage.py update_docs_and_index failing #1504

Open czue opened 3 months ago

czue commented 3 months ago

I'm trying to set up my development environment following the instructions in the README. When I run ./manage.py update_docs_and_index I get the following error:

Sphinx version error:
The sphinxcontrib.applehelp extension used by this project needs at least Sphinx v5.0; it therefore cannot be built with this version.
sphinx-build returned an error (release fr/5.0, builder json)

This appears to step from the Sphinx==4.5.0 requirement. I tried pinning Sphinx to 5.0.2 and it works, but I'm not sure that introduces any breaking changes to the built output.

czue commented 3 months ago

After this command failed I wasn't able to run it again without this change: https://github.com/django/djangoproject.com/pull/1507