@@ -3,6 +3,8 @@ name: Data checks
 # Guards the two classes of breakage the Python test suite can't see:
 #   1. a locale that drifted out of sync with en.json (renders raw keys in the UI)
 #   2. a shipped YAML/JSON file that doesn't parse (blows up at install time)
+#   3. a wiki/ change that breaks the admin panel's Manual: a page the bundle
+#      can't build, or a "?" button whose page or heading has gone
 
 on:
   push:
@@ -57,3 +59,9 @@ jobs:
 
       - name: Parse blueprints, sentences, locales and metadata
         run: python3 scripts/check_data_files.py
+
+      - name: Install the docs toolchain
+        run: python -m pip install -r requirements-docs.txt
+
+      - name: Bundle the manual and check the panel's help links
+        run: python3 scripts/build_manual.py --check
@@ -7,6 +7,9 @@ name: Attach HACS zip to release
 #
 # The zip's root must contain manifest.json directly: HACS extracts the archive
 # straight into custom_components/taskmate/.
+#
+# The zip also carries the Manual (wiki/ bundled by scripts/build_manual.py),
+# which is not in git: a release without it shows "read it on the website".
 
 on:
   release:
@@ -31,6 +34,20 @@ jobs:
           ref: ${{ github.event.release.tag_name }}
           persist-credentials: false
 
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+
+      # The admin panel's Manual page reads wiki/ from inside the integration.
+      # It is built here, not committed, so every release carries the docs as
+      # they stood at the tag. Same markdown setup as the website (docs.yml).
+      - name: Bundle the manual
+        run: |
+          python -m pip install -r requirements-docs.txt
+          python scripts/build_manual.py
+          test -s custom_components/taskmate/www/manual/manual.json || (echo "manual bundle missing" && exit 1)
+
       - name: Build taskmate.zip
         id: build
         run: |
@@ -40,6 +57,7 @@ jobs:
           cd "$GITHUB_WORKSPACE"
           echo "--- zip contents (top level) ---"
           unzip -l taskmate.zip | grep -E 'manifest.json' || (echo "manifest.json missing from zip root" && exit 1)
+          unzip -l taskmate.zip | grep -E 'www/manual/manual.json$' || (echo "manual bundle missing from zip" && exit 1)
           echo "sha256=$(sha256sum taskmate.zip | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
 
       - name: Attest build provenance for taskmate.zip
 
@@ -33,6 +33,9 @@ dev/config/.cloud/
 docs/
 .DS_Store
 
+# The Manual bundle: built from wiki/ by scripts/build_manual.py at release
+custom_components/taskmate/www/manual/
+
 # Node / JS tooling (CI-3)
 node_modules/
 
 
@@ -2017,7 +2017,22 @@
   "panel.tab_templates": "Skabeloner",
   "panel.tab_today": "I dag",
   "panel.tab_unknown": "Ukendt fane",
-  "panel.wiki_tooltip": "Åbn TaskMate-dokumentationen",
+  "panel.manual": "Vejledning",
+  "panel.manual_help": "Hjælp til denne side",
+  "panel.manual_open_web": "Åbn på hjemmesiden",
+  "panel.manual_open_full": "Åbn i vejledningen",
+  "panel.manual_search": "Søg i vejledningen",
+  "panel.manual_contents": "Indhold",
+  "panel.manual_on_this_page": "På denne side",
+  "panel.manual_prev": "Forrige",
+  "panel.manual_next": "Næste",
+  "panel.manual_version": "Dokumentation til v{version}",
+  "panel.manual_results": "Fundne sider: {count}",
+  "panel.manual_no_results": "Intet i vejledningen matcher det.",
+  "panel.manual_loading": "Indlæser vejledningen…",
+  "panel.manual_missing": "Vejledningen følger ikke med denne installation. Du kan læse den på hjemmesiden.",
+  "panel.manual_failed": "Vejledningen kunne ikke indlæses.",
+  "panel.manual_img_offline": "Skærmbilleder kræver en internetforbindelse.",
   "panel.notif_add_custom": "Tilføj egen notifikation",
   "panel.notif_add_parent": "Tilføj forælder",
   "panel.notif_custom_empty": "Ingen egne notifikationer endnu.",
 
@@ -1953,7 +1953,22 @@
   "panel.tab_templates": "Vorlagen",
   "panel.tab_today": "Heute",
   "panel.tab_unknown": "Unbekannter Tab",
-  "panel.wiki_tooltip": "TaskMate-Dokumentation öffnen",
+  "panel.manual": "Handbuch",
+  "panel.manual_help": "Hilfe zu dieser Seite",
+  "panel.manual_open_web": "Auf der Website öffnen",
+  "panel.manual_open_full": "Im Handbuch öffnen",
+  "panel.manual_search": "Handbuch durchsuchen",
+  "panel.manual_contents": "Inhalt",
+  "panel.manual_on_this_page": "Auf dieser Seite",
+  "panel.manual_prev": "Zurück",
+  "panel.manual_next": "Weiter",
+  "panel.manual_version": "Dokumentation für v{version}",
+  "panel.manual_results": "Gefundene Seiten: {count}",
+  "panel.manual_no_results": "Nichts im Handbuch passt dazu.",
+  "panel.manual_loading": "Handbuch wird geladen…",
+  "panel.manual_missing": "Das Handbuch ist in dieser Installation nicht enthalten. Du kannst es auf der Website lesen.",
+  "panel.manual_failed": "Das Handbuch konnte nicht geladen werden.",
+  "panel.manual_img_offline": "Screenshots brauchen eine Internetverbindung.",
   "panel.notif_add_custom": "Benutzerdefinierte Benachrichtigung hinzufügen",
   "panel.notif_add_parent": "Elternteil hinzufügen",
   "panel.notif_custom_empty": "Noch keine benutzerdefinierten Benachrichtigungen.",
 
@@ -2017,7 +2017,22 @@
   "panel.tab_templates": "Templates",
   "panel.tab_today": "Today",
   "panel.tab_unknown": "Unknown tab",
-  "panel.wiki_tooltip": "Open the TaskMate documentation",
+  "panel.manual": "Manual",
+  "panel.manual_help": "Help for this page",
+  "panel.manual_open_web": "Open on website",
+  "panel.manual_open_full": "Open in Manual",
+  "panel.manual_search": "Search the manual",
+  "panel.manual_contents": "Contents",
+  "panel.manual_on_this_page": "On this page",
+  "panel.manual_prev": "Previous",
+  "panel.manual_next": "Next",
+  "panel.manual_version": "Docs for v{version}",
+  "panel.manual_results": "Pages found: {count}",
+  "panel.manual_no_results": "Nothing in the manual matches that.",
+  "panel.manual_loading": "Loading the manual…",
+  "panel.manual_missing": "The manual isn't included in this install. You can read it on the website.",
+  "panel.manual_failed": "The manual couldn't be loaded.",
+  "panel.manual_img_offline": "Screenshots need an internet connection.",
   "panel.notif_add_custom": "Add custom notification",
   "panel.notif_add_parent": "Add parent",
   "panel.notif_custom_empty": "No custom notifications yet.",
 
@@ -2017,7 +2017,22 @@
   "panel.tab_templates": "Templates",
   "panel.tab_today": "Today",
   "panel.tab_unknown": "Unknown tab",
-  "panel.wiki_tooltip": "Open the TaskMate documentation",
+  "panel.manual": "Manual",
+  "panel.manual_help": "Help for this page",
+  "panel.manual_open_web": "Open on website",
+  "panel.manual_open_full": "Open in Manual",
+  "panel.manual_search": "Search the manual",
+  "panel.manual_contents": "Contents",
+  "panel.manual_on_this_page": "On this page",
+  "panel.manual_prev": "Previous",
+  "panel.manual_next": "Next",
+  "panel.manual_version": "Docs for v{version}",
+  "panel.manual_results": "Pages found: {count}",
+  "panel.manual_no_results": "Nothing in the manual matches that.",
+  "panel.manual_loading": "Loading the manual…",
+  "panel.manual_missing": "The manual isn't included in this install. You can read it on the website.",
+  "panel.manual_failed": "The manual couldn't be loaded.",
+  "panel.manual_img_offline": "Screenshots need an internet connection.",
   "panel.notif_add_custom": "Add custom notification",
   "panel.notif_add_parent": "Add parent",
   "panel.notif_custom_empty": "No custom notifications yet.",
 
@@ -1953,7 +1953,22 @@
   "panel.tab_templates": "Modèles",
   "panel.tab_today": "Aujourd'hui",
   "panel.tab_unknown": "Onglet inconnu",
-  "panel.wiki_tooltip": "Ouvrir la documentation TaskMate",
+  "panel.manual": "Manuel",
+  "panel.manual_help": "Aide pour cette page",
+  "panel.manual_open_web": "Ouvrir sur le site",
+  "panel.manual_open_full": "Ouvrir dans le manuel",
+  "panel.manual_search": "Rechercher dans le manuel",
+  "panel.manual_contents": "Sommaire",
+  "panel.manual_on_this_page": "Sur cette page",
+  "panel.manual_prev": "Précédent",
+  "panel.manual_next": "Suivant",
+  "panel.manual_version": "Documentation de la v{version}",
+  "panel.manual_results": "Pages trouvées : {count}",
+  "panel.manual_no_results": "Rien dans le manuel ne correspond.",
+  "panel.manual_loading": "Chargement du manuel…",
+  "panel.manual_missing": "Le manuel n'est pas inclus dans cette installation. Vous pouvez le lire sur le site.",
+  "panel.manual_failed": "Le manuel n'a pas pu être chargé.",
+  "panel.manual_img_offline": "Les captures d'écran nécessitent une connexion Internet.",
   "panel.notif_add_custom": "Ajouter une notification personnalisée",
   "panel.notif_add_parent": "Ajouter un parent",
   "panel.notif_custom_empty": "Aucune notification personnalisée pour l'instant.",
 
@@ -1953,7 +1953,22 @@
   "panel.tab_templates": "Maler",
   "panel.tab_today": "I dag",
   "panel.tab_unknown": "Ukjent fane",
-  "panel.wiki_tooltip": "Åpne TaskMate-dokumentasjonen",
+  "panel.manual": "Brukerveiledning",
+  "panel.manual_help": "Hjelp for denne siden",
+  "panel.manual_open_web": "Åpne på nettstedet",
+  "panel.manual_open_full": "Åpne i brukerveiledningen",
+  "panel.manual_search": "Søk i brukerveiledningen",
+  "panel.manual_contents": "Innhold",
+  "panel.manual_on_this_page": "På denne siden",
+  "panel.manual_prev": "Forrige",
+  "panel.manual_next": "Neste",
+  "panel.manual_version": "Dokumentasjon for v{version}",
+  "panel.manual_results": "Sider funnet: {count}",
+  "panel.manual_no_results": "Ingenting i brukerveiledningen passer.",
+  "panel.manual_loading": "Laster brukerveiledningen…",
+  "panel.manual_missing": "Brukerveiledningen følger ikke med denne installasjonen. Du kan lese den på nettstedet.",
+  "panel.manual_failed": "Brukerveiledningen kunne ikke lastes.",
+  "panel.manual_img_offline": "Skjermbilder krever internettilkobling.",
   "panel.notif_add_custom": "Legg til egendefinert varsel",
   "panel.notif_add_parent": "Legg til foresatt",
   "panel.notif_custom_empty": "Ingen egendefinerte varsler ennå.",
 
@@ -2017,7 +2017,22 @@
   "panel.tab_templates": "Sjablonen",
   "panel.tab_today": "Vandaag",
   "panel.tab_unknown": "Onbekend tabblad",
-  "panel.wiki_tooltip": "De TaskMate-wiki openen",
+  "panel.manual": "Handleiding",
+  "panel.manual_help": "Hulp bij deze pagina",
+  "panel.manual_open_web": "Op de website openen",
+  "panel.manual_open_full": "In de handleiding openen",
+  "panel.manual_search": "Zoeken in de handleiding",
+  "panel.manual_contents": "Inhoud",
+  "panel.manual_on_this_page": "Op deze pagina",
+  "panel.manual_prev": "Vorige",
+  "panel.manual_next": "Volgende",
+  "panel.manual_version": "Documentatie voor v{version}",
+  "panel.manual_results": "Gevonden pagina's: {count}",
+  "panel.manual_no_results": "Niets in de handleiding komt overeen.",
+  "panel.manual_loading": "Handleiding laden…",
+  "panel.manual_missing": "De handleiding zit niet in deze installatie. Je kunt hem op de website lezen.",
+  "panel.manual_failed": "De handleiding kon niet worden geladen.",
+  "panel.manual_img_offline": "Voor schermafbeeldingen is een internetverbinding nodig.",
   "panel.notif_add_custom": "Eigen melding toevoegen",
   "panel.notif_add_parent": "Ouder toevoegen",
   "panel.notif_custom_empty": "Nog geen eigen meldingen.",