add redirects config to conf file

Author: oraNod

docs/docsite/rst/conf.py

@@ -20,11 +20,10 @@
 import os
 from pathlib import Path
 
+import yaml
 
 DOCS_ROOT_DIR = Path(__file__).parent.resolve()
 
-sys.path.insert(0, str(DOCS_ROOT_DIR.parent / '_ext'))
-
 # If your extensions are in another directory, add it here. If the directory
 # is relative to the documentation root, use os.path.abspath to make it
 # absolute, like shown here.
@@ -71,7 +70,7 @@
     'notfound.extension',
     'sphinx_antsibull_ext',  # provides CSS for the plugin/module docs generated by antsibull
     'sphinx_copybutton',
-    'ansible_redirects',
+    'sphinx_reredirects', # redirects pages that have been restructured or removed
 ]
 
 # Later on, add 'sphinx.ext.viewcode' to the list if you want to have
@@ -379,7 +378,7 @@
 autoclass_content = 'both'
 
 # Note:  Our strategy for intersphinx mappings is to have the upstream build location as the
-# canonical source. 
+# canonical source.
 intersphinx_mapping = {
     'python': ('https://docs.python.org/2/', None),
     'python3': ('https://docs.python.org/3/', None),
@@ -393,3 +392,13 @@
 ]
 linkcheck_workers = 25
 # linkcheck_anchors = False
+
+# Generate redirects for pages that have been restructured or moved
+# if EXTRA_TAGS="-t redirects" is passed with the make invocation
+redirects = {}
+if tags.has('redirects'):
+    redirects_config_path = DOCS_ROOT_DIR.parent / "ansible_redirects.yaml"
+    redirect_keys = yaml.safe_load(
+      redirects_config_path.read_text(encoding="utf-8")
+    )
+    redirects = redirect_keys