From 324a38bafcbea2d560dd48cede36131b588bc53d Mon Sep 17 00:00:00 2001 From: Gregory Oschwald Date: Tue, 9 May 2023 14:29:03 -0700 Subject: [PATCH 1/3] Stop using build_sphinx --- dev-bin/release.sh | 5 +++-- setup.cfg | 3 --- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/dev-bin/release.sh b/dev-bin/release.sh index 12118c08..0fcc10a8 100755 --- a/dev-bin/release.sh +++ b/dev-bin/release.sh @@ -63,6 +63,7 @@ gh release create --target "$(git branch --show-current)" -t "$version" -n "$not git push --tags -rm -fr dist -python setup.py build_html sdist +rm -fr build dist +python -m sphinx -M html ./docs ./build/sphinx -W +python setup.py sdist twine upload dist/* diff --git a/setup.cfg b/setup.cfg index 47a5047b..7e3c6000 100644 --- a/setup.cfg +++ b/setup.cfg @@ -1,6 +1,3 @@ -[aliases] -build_html = build_sphinx -b html --build-dir docs - [flake8] extend-ignore = E203 # black uses 88 : ¯\_(ツ)_/¯ From dafdbcb4ef7668ea8d455963a591290ddeb2db8f Mon Sep 17 00:00:00 2001 From: Gregory Oschwald Date: Tue, 9 May 2023 14:29:11 -0700 Subject: [PATCH 2/3] Fix sphinx build warnings --- docs/conf.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 66c3eb7e..ad32d473 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -131,7 +131,7 @@ # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ["_static"] +# html_static_path = ["_static"] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. @@ -250,4 +250,6 @@ # texinfo_show_urls = 'footnote' # Example configuration for intersphinx: refer to the Python standard library. -intersphinx_mapping = {"http://docs.python.org/": None} +intersphinx_mapping = { + "python": ("https://python.readthedocs.org/en/latest/", None), +} From 96a60eee52289fb203038749168101a5c07f0869 Mon Sep 17 00:00:00 2001 From: Gregory Oschwald Date: Wed, 10 May 2023 14:00:02 -0700 Subject: [PATCH 3/3] Work around Read the Docs build issue See https://github.com/readthedocs/readthedocs.org/issues/10290 --- .readthedocs.yaml | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 .readthedocs.yaml diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 00000000..4b74802e --- /dev/null +++ b/.readthedocs.yaml @@ -0,0 +1,6 @@ +version: 2 + +build: + os: ubuntu-22.04 + tools: + python: "3.11"