diff --git a/docs/.sphinx/requirements.txt b/docs/.sphinx/requirements.txt index 479ade97a9..ee0598a11a 100644 --- a/docs/.sphinx/requirements.txt +++ b/docs/.sphinx/requirements.txt @@ -2,3 +2,4 @@ canonical-sphinx[full] @ git+https://github.com/canonical/canonical-sphinx@main sphinx-autobuild sphinxcontrib-svg2pdfconverter[CairoSVG] sphinx-last-updated-by-git +sphinx-sitemap diff --git a/docs/conf.py b/docs/conf.py index 07fefa1ede..554c2e89a8 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -26,7 +26,7 @@ project = "Multipass" author = "Canonical Ltd." -#root_doc = "src/index" +# root_doc = "src/index" # Sidebar documentation title; best kept reasonably short # @@ -72,6 +72,8 @@ ogp_site_url = "https://documentation.ubuntu.com/multipass" +html_baseurl = "https://documentation.ubuntu.com/multipass/" # for sitemap.xml, the trailing slash is important +sitemap_url_scheme = "en/latest/{link}" # Preview name of the documentation website # @@ -162,7 +164,7 @@ # TODO: If your documentation is hosted on https://docs.ubuntu.com/, # uncomment and update as needed. -slug = 'multipass' +slug = "multipass" # Template and asset locations @@ -196,7 +198,7 @@ # TODO: Remove or adjust the ACME entry after you update the contributing guide linkcheck_ignore = [ - "https://app.element.io/#/room/#Multipass:matrix.org", + "https://app.element.io/#/room/#Multipass:matrix.org", "http://127.0.0.1:8000", "http://127.0.0.1:8001", "https://localhost:8080", @@ -205,8 +207,8 @@ "https://sourceforge.net/projects/vcxsrv/", "https://sourceforge.net/projects/xming/", "http://www.straightrunning.com/XmingNotes/", - "https://unix.stackexchange.com", # it seems stackexchange is now blocking bots - ] + "https://unix.stackexchange.com", # it seems stackexchange is now blocking bots +] linkcheck_retries = 3 @@ -250,6 +252,7 @@ "canonical_sphinx", "sphinxcontrib.cairosvgconverter", "sphinx_last_updated_by_git", + "sphinx_sitemap", ] # Excludes files or directories from processing