pyramid_cookbook icon indicating copy to clipboard operation
pyramid_cookbook copied to clipboard

Initial build of html docs fails with a 404

Open kpinc opened this issue 11 months ago • 1 comments

Hi,

Following the instructions here: https://github.com/Pylons/pyramid_cookbook/blob/master/contributing.md

In the Build HTML docs step, the build fails with a 404.

$ make html SPHINXBUILD=../../venv/bin/sphinx-build 
../../venv/bin/sphinx-build -b html -d _build/doctrees  -W . _build/html
Running Sphinx v7.2.6
making output directory... done
loading intersphinx inventory from https://docs.python.org/objects.inv...
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://docs.pylonsproject.org/projects/pyramid/en/latest/objects.inv...
loading intersphinx inventory from https://docs.pylonsproject.org/projects/pyramid-tutorials/en/latest/objects.inv...
intersphinx inventory has moved: https://docs.python.org/objects.inv -> https://docs.python.org/3/objects.inv

Warning, treated as error:
failed to reach any of the inventories with the following issues:
intersphinx inventory 'https://docs.pylonsproject.org/projects/pyramid-tutorials/en/latest/objects.inv' not fetchable due to <class 'requests.exceptions.HTTPError'>: 404 Client Error: Not Found for url: https://docs.pylonsproject.org/projects/pyramid-tutorials/en/latest/objects.inv
make: *** [Makefile:40: html] Error 2

Looks like the inventory url has moved to: https://docs.python.org/3/objects.inv

kpinc avatar Mar 29 '24 16:03 kpinc

The quick and dirty work-around is to tell the build process to ignore warnings by removing the -W sphinx-build option by passing SPHINXOPTS='' to make.

$ make SPHINXOPTS='' html SPHINXBUILD=../../venv/bin/sphinx-build 

kpinc avatar Mar 29 '24 16:03 kpinc