Merge pull request #147 from maxmind/greg/no-build-sphinx

Do not use build_sphinx

Author: oschwald

.readthedocs.yaml

@@ -0,0 +1,6 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"

dev-bin/release.sh

@@ -62,6 +62,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 bdist_wheel
+rm -fr build dist
+python -m sphinx -M html ./docs ./build/sphinx
+python setup.py sdist bdist_wheel
 twine upload dist/*

docs/conf.py

@@ -127,7 +127,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.
@@ -246,4 +246,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),
+}

setup.cfg

@@ -1,6 +1,3 @@
-[aliases]
-build_html = build_sphinx -b html --build-dir docs
-
 [flake8]
 # black uses 88 : ¯\_(ツ)_/¯
 max-line-length = 88