Add redirect and fix display issue for warningbox

Author: Eeems

README.md

@@ -71,16 +71,7 @@ Yes, you usually will want to accomplish this by just changing the first header
 ```rst
 :orphan:
 
-This page has been moved to :doc:`new-page-name`.
-
-.. raw:: html
-
-  <noscript>
-    <meta http-equiv="refresh" content="0; url=/new-page-name.html"/>
-  </noscript>
-  <script>
-    location.pathname = "/new-page-name.html";
-  </script>
+.. redirect:: new-page-name
 ```
 
 ### How to I add a warning to a page?

src/_ext/__init__.py

@@ -1,6 +1,7 @@
 from .fixme import FixMeDirective
 from .gallery import GalleryDirective
 from .warningbox import WarningBoxDirective
+from .redirect import RedirectDirective
 
 from sphinx.application import Sphinx
 from sphinx.util.typing import ExtensionMetadata
@@ -10,6 +11,7 @@ def setup(app: Sphinx) -> ExtensionMetadata:
     app.add_directive("fixme", FixMeDirective)
     app.add_directive("warningbox", WarningBoxDirective)
     app.add_directive("gallery", GalleryDirective)
+    app.add_directive("redirect", RedirectDirective)
 
     return {
         "version": "0.1",

src/_ext/__pycache__/__init__.cpython-313.pyc

@@ -0,0 +1,22 @@
+from docutils import nodes
+
+from sphinx.util.docutils import SphinxDirective
+
+from .utils import RawHTML
+
+
+class RedirectDirective(SphinxDirective):
+    required_arguments = 1
+
+    def run(self) -> list[nodes.Node]:
+        new_page = self.arguments[0]
+        new_uri = self.env.app.builder.get_target_uri(new_page)
+        return [
+            *self.parse_text_to_nodes(
+                f"This page has been moved to  :doc:`{new_page}`."
+            ),
+            RawHTML(
+                f'<noscript><meta http-equiv="refresh" content="0; url={new_uri}"/></noscript>'
+            ),
+            RawHTML(f'<script>location.href = "{new_uri}";</script>'),
+        ]

src/_ext/__pycache__/redirect.cpython-313.pyc

@@ -16,8 +16,7 @@ class WarningBoxDirective(SphinxDirective):
     def run(self) -> list[nodes.Node]:
         return [
             RawHTML('<div class="warning">'),
-            nodes.inline(text=f"⚠️ {self.options['title']} ⚠️"),
-            RawHTML("<br/>"),
+            *self.parse_text_to_nodes(f"⚠️ {self.options['title']} ⚠️"),
             *self.parse_content_to_nodes(),
             RawHTML("</div>"),
         ]

src/_ext/__pycache__/warningbox.cpython-313.pyc

@@ -1,12 +1,3 @@
 :orphan:
 
-This page has been moved to :doc:`../config/screens`.
-
-.. raw:: html
-
-  <noscript>
-    <meta http-equiv="refresh" content="0; url=/guide/config/screens.html"/>
-  </noscript>
-  <script>
-    location.pathname = "/guide/config/screens.html";
-  </script>
+.. redirect:: ../config/screens

src/_ext/redirect.py

@@ -1,12 +1,3 @@
 :orphan:
 
-This page has been moved to :doc:`../config/templates`.
-
-.. raw:: html
-
-  <noscript>
-    <meta http-equiv="refresh" content="0; url=/guide/config/templates.html"/>
-  </noscript>
-  <script>
-    location.pathname = "/guide/config/templates.html";
-  </script>
+.. redirect:: ../config/templates

src/_ext/warningbox.py

@@ -3,7 +3,7 @@ Toltec
 ======
 
 .. warningbox::
-  :title: Always refer to the <a href="https://toltec-dev.org">toltec website</a> for up to date information
+  :title: Always refer to the `toltec website <https://toltec-dev.org>`_ for up to date information
 
   The website contains up to date information on what version of the OS is supported, as well as the latest installation steps.