Use sphinx-sitemap to create a sitemap

.github/workflows/branch-man.yml

@@ -26,8 +26,8 @@ jobs:
       - name: Install Python packages
         run: >
             pip3 install dnspython beautifulsoup4 pyxdg requests \
-                         sphinx sphinx_epytext sphinx_rtd_theme sphinx-intl \
-                         setuptools_scm
+                         sphinx sphinx_epytext sphinx_rtd_theme sphinx-sitemap \
+                         sphinx-intl setuptools_scm
 
       - name: Prepare git environment
         run: |

.github/workflows/build.yml

@@ -102,7 +102,8 @@ jobs:
 
       - name: Install Python packages
         run: |
-          pip install -r requirements.txt Sphinx sphinx-epytext sphinx-intl sphinx-rtd-theme
+          pip install -r requirements.txt Sphinx sphinx-epytext sphinx-intl \
+            sphinx-rtd-theme sphinx-sitemap
 
       - name: Build
         run: |

.github/workflows/publish-pages.yml

@@ -28,7 +28,7 @@ jobs:
       - name: Install Python packages
         run: >
             pip install dnspython beautifulsoup4 pyxdg requests \
-                        sphinx sphinx_epytext sphinx_rtd_theme
+                        sphinx sphinx_epytext sphinx_rtd_theme sphinx-sitemap
 
       - name: Build
         run: |

doc/documentation.md

@@ -14,6 +14,8 @@ sphinx_epytext
 
 sphinx_rtd_theme
 
+sphinx_sitemap
+
 Configuration
 -------------
 

doc/src/conf.py

@@ -22,6 +22,7 @@ extensions = [
     'sphinx.ext.viewcode',
     'sphinx_epytext',
     'sphinx_rtd_theme',
+    'sphinx_sitemap',
 ]
 
 locale_dirs = ['../i18n/locales']
@@ -81,6 +82,13 @@ extlinks = {'pypi': ('https://pypi.org/project/%s/', '')}
 
 graphviz_output_format = 'svg'
 
+# sitemap
+html_baseurl = 'https://linkchecker.github.io/linkchecker/'
+
+sitemap_locales = [None]
+
+sitemap_url_scheme = "{link}"
+
 # -- Mock --------------------------------------------------------------------
 
 import linkcheck.logger