Improving 404 handling - fixes #28

.drone.yml

@@ -28,7 +28,7 @@ steps:
   - cd ~/docs
   - pip install --upgrade pip
   - pip install -r requirements.txt
-  - make html
+  - make dirhtml
 
 trigger:
   event:
@@ -69,7 +69,7 @@ steps:
   - cd ~/docs
   - pip install --upgrade pip
   - pip install -r requirements.txt
-  - make html
+  - make dirhtml
 - name: deploy to staging
   image: appleboy/drone-scp
   volumes:
@@ -127,7 +127,7 @@ steps:
   - cd ~/docs
   - pip install --upgrade pip
   - pip install -r requirements.txt
-  - make html
+  - make dirhtml
 - name: deploy to production
   image: appleboy/drone-scp
   volumes:

.gitignore

@@ -1,3 +1,4 @@
 build/html/
+build/dirhtml/
 .venv/
 .vscode/

requirements.txt

@@ -1,2 +1,3 @@
 furo==2023.5.20
 sphinx-intl==2.1.0
+sphinx-notfound-page==0.8.3

source/404.rst

@@ -0,0 +1,8 @@
+:orphan:
+
+Seite nicht gefunden
+====================
+
+Die angeforderte Seite konnte nicht gefunden werden. Sie können unsere Suche in der Navigation verwenden, um Inhalte zu finden.
+
+Falls Sie Verbesserungsvorschläge einreichen wollen, erstellen Sie bitte einen `Beitrag in der Forge <https://forge.nick-slowinski.de/nick-slowinski.de/docs/issues/>`_ oder tragen Sie direkt bei.

source/conf.py

@@ -13,7 +13,9 @@ author = 'Nick Slowinski'
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = []
+extensions = [
+    'notfound.extension',
+]
 
 templates_path = ['_templates']
 exclude_patterns = []
@@ -34,3 +36,6 @@ html_theme_options = {
     "announcement": "<em>Diese Dokumentation befindet sich noch im Aufbau und wird nach für nach vervollständigt.</em>",
     "source_edit_link": "https://forge.nick-slowinski.de/nick-slowinski.de/docs/_edit/main/source/{filename}",
 }
+
+# 404 extension
+notfound_urls_prefix = None