Enable Sphinx auto section labels. Minor doc link fix.

This commit is contained in:
Dion Moult
2023-09-08 12:06:47 +10:00
parent e897797955
commit 2843d1e13e
4 changed files with 19 additions and 11 deletions
+4 -1
View File
@@ -54,7 +54,10 @@ release = "0.7.0"
# - No subnav making it really hard to navigate
# - Kinda hacky setup https://stackoverflow.com/questions/2701998/sphinx-autodoc-is-not-automatic-enough
# - I couldn't customise the template to show submodules above members which makes API discovery hard for users
extensions = ["autoapi.extension"]
extensions = ["autoapi.extension", "sphinx.ext.autosectionlabel"]
# Auto add document prefixes to help guarantee uniqueness of automatic section references.
autosectionlabel_prefix_document = True
# We'll add the toctree entry ourselves to distinguish between C++ and Python
autoapi_add_toctree_entry = True