diff --git a/.github/workflows/build-sphinx-docs.yml b/.github/workflows/build-sphinx-docs.yml index 4137414..a84352c 100644 --- a/.github/workflows/build-sphinx-docs.yml +++ b/.github/workflows/build-sphinx-docs.yml @@ -26,6 +26,9 @@ jobs: steps: - name: Checkout uses: actions/checkout@v4 + with: + fetch-depth: 0 + filter: blob:none - name: Setup Python uses: actions/setup-python@v5 with: diff --git a/docs/conf.py b/docs/conf.py index c93ed4a..b441083 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -141,10 +141,14 @@ def setup(app): html_show_sourcelink = True # False on private repos; True on public repos html_theme = "pydata_sphinx_theme" html_title = project -html_baseurl = "https://docs.saltproject.io/salt/install-guide/" - -# Extends baseurl, in combination with version value -sitemap_locales = ["en"] +html_baseurl = "https://docs.saltproject.io/salt/install-guide/en/latest/" +sitemap_url_scheme = ( + "{link}" # lang/version now live in html_baseurl, so canonical is correct too +) +sitemap_locales = [ + None +] # single-language site: drop redundant self-referential xhtml:link alternates +sitemap_show_lastmod = True # git commit time of each source .rst # Pages we don't care to include in generated sitemap file sitemap_excludes = [ "search.html", diff --git a/docs/requirements.txt b/docs/requirements.txt index e69c9e2..07de705 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -2,7 +2,7 @@ pydata-sphinx-theme==0.20.0 sphinx-copybutton>=0.5.2 sphinx-design>=0.5.0 sphinx-inline-tabs>=2023.4.21 -sphinx-sitemap==2.6.0 +sphinx-sitemap==2.9.0 sphinx-substitution-extensions>=2022.02.16 sphinx-tabs>=3.4.7 sphinx>=5.3.0