Fix rendering of 404 (#209)

kattni · web-flow · commit fe6e2c8cd6f1 · 2026-04-20T09:57:33.000+08:00
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -4,6 +4,7 @@ repos:
     hooks:
       - id: check-toml
       - id: check-yaml
+        args: ['--unsafe']
       - id: check-case-conflict
       - id: end-of-file-fixer
         # PO files may not have a trailing EOL, as they are tool generated
diff --git a/docs/mkdocs.ar.yml b/docs/mkdocs.ar.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: أدوات مستندات BeeWare
-site_url: https://beeware-docs-tools.readthedocs.io/ar/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: ar
 
 theme:
diff --git a/docs/mkdocs.cs.yml b/docs/mkdocs.cs.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: Nástroje pro dokumenty BeeWare
-site_url: https://beeware-docs-tools.readthedocs.io/cs/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: cs
 
 theme:
diff --git a/docs/mkdocs.da.yml b/docs/mkdocs.da.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare Docs-værktøjer
-site_url: https://beeware-docs-tools.readthedocs.io/da/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: da
 
 theme:
diff --git a/docs/mkdocs.de.yml b/docs/mkdocs.de.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare Werkzeuge für die Dokumentation
-site_url: https://beeware-docs-tools.readthedocs.io/de/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: de
 
 theme:
diff --git a/docs/mkdocs.en.yml b/docs/mkdocs.en.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare Docs Tools
-site_url: https://beeware-docs-tools.readthedocs.io/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: en
 
 theme:
diff --git a/docs/mkdocs.es.yml b/docs/mkdocs.es.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: Herramientas de BeeWare Docs
-site_url: https://beeware-docs-tools.readthedocs.io/es/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: es
 
 theme:
diff --git a/docs/mkdocs.fa.yml b/docs/mkdocs.fa.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: ابزارهای اسناد BeeWare
-site_url: https://beeware-docs-tools.readthedocs.io/fa/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: fa
 
 theme:
diff --git a/docs/mkdocs.fr.yml b/docs/mkdocs.fr.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare Outils Docs
-site_url: https://beeware-docs-tools.readthedocs.io/fr/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: fr
 
 theme:
diff --git a/docs/mkdocs.it.yml b/docs/mkdocs.it.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: Strumenti di documentazione BeeWare
-site_url: https://beeware-docs-tools.readthedocs.io/it/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: it
 
 theme:
diff --git a/docs/mkdocs.ja.yml b/docs/mkdocs.ja.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare ドキュメントツール
-site_url: https://beeware-docs-tools.readthedocs.io/ja/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: ja
 
 theme:
diff --git a/docs/mkdocs.ko.yml b/docs/mkdocs.ko.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare Docs Tools
-site_url: https://beeware-docs-tools.readthedocs.io/ko/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: ko
 
 theme:
diff --git a/docs/mkdocs.pl.yml b/docs/mkdocs.pl.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: Narzędzia BeeWare Docs
-site_url: https://beeware-docs-tools.readthedocs.io/pl/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: pl
 
 theme:
diff --git a/docs/mkdocs.pt.yml b/docs/mkdocs.pt.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: Ferramentas de documentação BeeWare
-site_url: https://beeware-docs-tools.readthedocs.io/pt/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: pt
 
 theme:
diff --git a/docs/mkdocs.ru.yml b/docs/mkdocs.ru.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: Инструменты для работы с документацией BeeWare
-site_url: https://beeware-docs-tools.readthedocs.io/ru/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: ru
 
 theme:
diff --git a/docs/mkdocs.tr.yml b/docs/mkdocs.tr.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare Dokümanları Araçları
-site_url: https://beeware-docs-tools.readthedocs.io/tr/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: tr
 
 theme:
diff --git a/docs/mkdocs.zh_CN.yml b/docs/mkdocs.zh_CN.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare 文档工具
-site_url: https://beeware-docs-tools.readthedocs.io/zh_CN/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: zh_CN
 
 theme:
diff --git a/docs/mkdocs.zh_TW.yml b/docs/mkdocs.zh_TW.yml
@@ -1,6 +1,6 @@
 INHERIT: config.yml
 site_name: BeeWare 文檔工具
-site_url: https://beeware-docs-tools.readthedocs.io/zh_TW/
+site_url: !ENV READTHEDOCS_CANONICAL_URL
 docs_dir: zh_TW
 
 theme:
diff --git a/src/beeware_docs_tools/overrides/404.html b/src/beeware_docs_tools/overrides/404.html
@@ -22,15 +22,40 @@
 
 {% extends "main.html" %}
 
+{% block styles %}
+    {{ super() }}
+    <style>
+        h1,
+        #not-found-text {
+            font-family: 'Cutive';
+            padding: 1rem;
+        }
+
+        #not-found-bee-long {
+            padding: 1rem;
+            @media screen and (max-width: 48.8rem) {
+                display: none;
+            }
+        }
+
+        #not-found-bee-short {
+            padding: 1rem;
+            @media screen and (min-width: 48.8rem) {
+                display: none;
+            }
+        }
+    </style>
+{% endblock %}
+
 {% block content %}
-  <h1 style="font-family:Cutive;padding:1rem;">404: Page not found</h1>
-    <div class="not-found-bees" style="padding:1rem;">
-    <img src="{{ 'assets/images/bumble.png' | url }}"  alt="Brutus the bee flying along with a dashed trail behind him" />
+  <h1>404: Page not found</h1>
+    <div id="not-found-bee-long">
+    <img src="{{ 'assets/images/bumble.png' | url }}" alt="Brutus the bee flying along with a dashed trail behind him" />
     </div>
-    <div class="not-found-bees" style="padding:1rem;">
+    <div id="not-found-bee-short">
     <img src="{{ 'assets/images/bumble-small.png' | url }}" alt="Brutus the bee flying along with a dashed trail behind him" />
     </div>
-    <div id="not-found-text" style="font-family:Cutive;padding:1rem;">
+    <div id="not-found-text">
       <h2>Brutus can't find what you're looking for</h2>
     </div>
 {% endblock %}
diff --git a/src/beeware_docs_tools/overrides/partials/header.html b/src/beeware_docs_tools/overrides/partials/header.html
@@ -150,5 +150,5 @@
         {% include "partials/search.html" %}
       {% endif %}
     {% endif %}
-  </nav>
+    </nav>
 </header>
diff --git a/tox.ini b/tox.ini
@@ -32,6 +32,7 @@ setenv =
     DISABLE_MKDOCS_2_WARNING = true
 passenv =
     DEEPL_API_KEY
+    READTHEDOCS_CANONICAL_URL
 deps =
     -e .
 commands:
