mkdocs-kern-ux 0.2.0__tar.gz

mkdocs_kern_ux-0.2.0/.gitignore

@@ -0,0 +1,26 @@
+# Node (nur Dev-Tooling; der gevendorte Kit selbst wird eingecheckt!)
+node_modules/
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+venv/
+
+# MkDocs - Bauergebnisse.
+# demo/export/ steht bewusst NICHT hier: der Offline-Export der Demo wird
+# mit eingecheckt, damit er sich ohne Werkzeuge anschauen und weitergeben
+# laesst.
+demo/site/
+demo/site-minimal/
+site/
+
+# Editoren / OS
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

mkdocs_kern_ux-0.2.0/CHANGELOG.md

@@ -0,0 +1,72 @@
+# Änderungsverlauf
+
+Das Format orientiert sich an [Keep a Changelog](https://keepachangelog.com/de/1.1.0/),
+die Versionierung an [Semantic Versioning](https://semver.org/lang/de/).
+
+Jede Version nennt die gebündelten Fremdpakete, damit nachvollziehbar bleibt,
+welcher KERN-Kit ausgeliefert wurde.
+
+## [0.2.0] – 2026-09-17
+
+Erste Veröffentlichung auf openCode, Demo unter <https://kern-ux-theme-for-mkdocs-fda32d.usercontent.opencode.de/>.
+
+### Behoben
+
+- Seitenrahmen trägt nicht mehr `kern-container`. Der Kit setzt
+  `.kern-container:has(.kern-grid) { padding: 0 }`; dadurch verlor das
+  Seitenlayout sein Seitenpolster, sobald eine Seite ein `kern-grid` enthielt –
+  der Inhalt griff ins Layout durch. `.kux-shell` übernimmt Zentrierung,
+  Breite und Polster jetzt selbst.
+- Lange Codezeilen scrollen wieder, statt mitten im Wort umzubrechen: `<pre>`
+  erbt kein `overflow-wrap: anywhere` mehr.
+- highlight.js machte über `.hljs { overflow-x: auto }` das `<code>` zum
+  zweiten Scrollcontainer. Dadurch meldete das `<pre>` keinen Überlauf und
+  wurde nicht als Tastaturregion ausgezeichnet (WCAG 2.1.1).
+- Escape schließt den Suchdialog auch aus dem Suchfeld heraus. Chrome
+  verbraucht den Tastendruck dort sonst fürs Leeren des Feldes, und der
+  modale Dialog blieb offen.
+
+### Hinzugefügt
+
+- `npm run demo:check`: prüft im echten Browser die Layout-Geometrie aller
+  Demoseiten sowie Suche, Codeblöcke, Design-Umschalter und Gliederung.
+- `demo/mkdocs.export.yml` erzeugt einen Offline-Export nach `demo/export/`.
+- `VEROEFFENTLICHEN.md`, `publiccode.yml`, `.gitlab-ci.yml` mit Test, Paketbau, Demo als
+  GitLab Pages, Release und optionalem PyPI-Upload.
+
+### Gebündelt
+
+- `@kern-ux/native` 2.6.1 (EUPL-1.2)
+- `@highlightjs/cdn-assets` 11.11.1 (BSD 3-Clause)
+
+## [0.1.0] – 2026-09-03
+
+Erste Fassung.
+
+### Hinzugefügt
+
+- MkDocs-Theme `kern-ux` als installierbares Python-Paket, zusätzlich als
+  `custom_dir` nutzbar
+- Vollständiger KERN-Kit unverändert gebündelt, Aktualisierung über
+  `npm run kern:update`
+- Dokumentations-Navigation: Baum in der Seitenleiste, Gliederungsspalte mit
+  Abschnittsmarkierung, Brotkrumenpfad, Zurück/Weiter, Bearbeiten-Link
+- Abbildung der Markdown-Ausgabe auf KERN: Typografie, Hinweise
+  (`admonition`, `pymdownx.details`), Tabellen, Aufklappbereiche, Fußnoten,
+  Code
+- Syntaxhervorhebung mit lokal gebündeltem highlight.js, Farbschema folgt dem
+  hellen bzw. dunklen Design
+- Umschalter hell/dunkel über `data-kern-theme`, ohne Aufblitzen beim Laden
+- Suche als KERN-Dialog auf Basis des mitgelieferten Such-Plugins, mit
+  Suchseite als Rückfallebene ohne JavaScript
+- Deutsche Oberfläche; jeder sichtbare Text über `theme:` überschreibbar
+- Optionsnamen der mitgelieferten Themes `mkdocs` und `readthedocs` werden
+  unterstützt (`navigation_depth`, `collapse_navigation`, `sticky_navigation`,
+  `titles_only`, `prev_next_buttons_location`, `include_homepage_in_sidebar`,
+  `analytics.gtag`, `hljs_*`, `color_mode`, `user_color_mode_toggle`)
+- Demo-Site mit zwei Profilen (`demo/mkdocs.yml`, `demo/mkdocs.minimal.yml`)
+
+### Gebündelt
+
+- `@kern-ux/native` 2.6.1 (EUPL-1.2)
+- `@highlightjs/cdn-assets` 11.11.1 (BSD 3-Clause)

mkdocs_kern_ux-0.2.0/LICENSE

@@ -0,0 +1,163 @@
+mkdocs-kern-ux - MkDocs-Theme auf Basis des KERN-UX Design-Systems
+Copyright (C) 2026 Samtgemeinde Emlichheim, Michi91
+
+Lizenziert unter der EUPL, Version 1.2 oder - sobald von der Europaeischen
+Kommission genehmigt - spaeteren Versionen der EUPL (die "Lizenz").
+Sie duerfen dieses Werk ausschliesslich gemaess dieser Lizenz nutzen.
+Eine Kopie der Lizenz finden Sie unter:
+https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12
+
+Der Lizenztext ist unten vollstaendig wiedergegeben.
+
+Gebuendelte Fremdsoftware steht unter eigenen Lizenzen; siehe THIRD-PARTY.md.
+
+================================================================================
+
+# EUROPÄISCHE UNION PUBLIC LICENCE v. 1.2
+EUPL © Europäische Union 2007, 2016
+
+Diese Europäische Union Public Licence (die „EUPL") gilt für Werke (entsprechend der nachstehenden Begriffsbestimmung), die unter EUPL-Bedingungen zur Verfügung gestellt werden. Das Werk darf nur in der durch diese Lizenz gestatteten Form genutzt werden (insoweit eine solche Nutzung dem Urheber vorbehalten ist).
+
+Das Werk wird unter den Bedingungen dieser Lizenz zur Verfügung gestellt, wenn der Lizenzgeber (entsprechend der nachstehenden Begriffsbestimmung) den folgenden Hinweis unmittelbar hinter dem Urheberrechtshinweis dieses Werks anbringt:
+
+Lizenziert unter der EUPL
+
+oder in einer anderen Form zum Ausdruck bringt, dass er es unter der EUPL lizenzieren möchte.
+
+## 1. Begriffsbestimmungen
+
+Für diese Lizenz gelten folgende Begriffsbestimmungen:
+
+- **„Lizenz"**: diese Lizenz.
+- **„Originalwerk"**: das Werk oder die Software, die vom Lizenzgeber unter dieser Lizenz verbreitet oder zugänglich gemacht wird, und zwar als Quellcode und gegebenenfalls auch als ausführbarer Code.
+- **„Bearbeitungen"**: die Werke oder Software, die der Lizenznehmer auf der Grundlage des Originalwerks oder seiner Bearbeitungen schaffen kann. In dieser Lizenz wird nicht festgelegt, wie umfangreich die Änderung oder wie stark die Abhängigkeit vom Originalwerk für eine Einstufung als Bearbeitung sein muss.
+- **„Werk"**: das Originalwerk oder seine Bearbeitungen.
+- **„Quellcode"**: diejenige Form des Werks, die zur Auffassung durch den Menschen bestimmt ist und die am besten geeignet ist, um vom Menschen verstanden und verändert zu werden.
+- **„Ausführbarer Code"**: die – üblicherweise – kompilierte Form des Werks, die von einem Computer als Programm ausgeführt werden soll.
+- **„Lizenzgeber"**: die natürliche oder juristische Person, die das Werk unter der Lizenz verbreitet oder zugänglich macht.
+- **„Bearbeiter"**: jede natürliche oder juristische Person, die das Werk unter der Lizenz verändert oder auf andere Weise zur Schaffung einer Bearbeitung beiträgt.
+- **„Lizenznehmer" oder „Sie"**: jede natürliche oder juristische Person, die das Werk unter den Lizenzbedingungen nutzt.
+- **„Verbreitung" oder „Zugänglichmachung"**: alle Formen von Verkauf, Überlassung, Verleih, Vermietung, Verbreitung, Weitergabe, Übermittlung oder anderweitiger Online- oder Offline-Bereitstellung von Vervielfältigungen des Werks oder Zugänglichmachung seiner wesentlichen Funktionen für dritte natürliche oder juristische Personen.
+
+## 2. Umfang der Lizenzrechte
+
+Der Lizenzgeber erteilt Ihnen hiermit für die Gültigkeitsdauer der am Originalwerk bestehenden Urheberrechte eine weltweite, unentgeltliche, nicht ausschließliche, unterlizenzierbare Lizenz, die Sie berechtigt:
+
+- das Werk uneingeschränkt zu nutzen,
+- das Werk zu vervielfältigen,
+- das Werk zu verändern und Bearbeitungen auf der Grundlage des Werks zu schaffen,
+- das Werk öffentlich zugänglich zu machen, was das Recht einschließt, das Werk oder Vervielfältigungsstücke davon öffentlich bereit zu stellen oder wahrnehmbar zu machen oder das Werk, soweit möglich, öffentlich aufzuführen,
+- das Werk oder Vervielfältigungen davon zu verbreiten,
+- das Werk oder Vervielfältigungen davon zu vermieten oder zu verleihen,
+- das Werk oder Vervielfältigungen davon zu unterlizenzieren.
+
+Für die Wahrnehmung dieser Rechte können beliebige, derzeit bekannte oder künftige Medien, Träger und Formate verwendet werden, soweit das geltende Recht dem nicht entgegensteht.
+
+Für die Länder, in denen Urheberpersönlichkeitsrechte an dem Werk bestehen, verzichtet der Lizenzgeber im gesetzlich zulässigen Umfang auf seine Urheberpersönlichkeitsrechte, um die Lizenzierung der oben aufgeführten Verwertungsrechte wirksam werden zu lassen.
+
+Der Lizenzgeber erteilt dem Lizenznehmer ein nicht ausschließliches, unentgeltliches Nutzungsrecht an seinen Patenten, sofern dies zur Ausübung der durch die Lizenz erteilten Nutzungsrechte am Werk notwendig ist.
+
+## 3. Zugänglichmachung des Quellcodes
+
+Der Lizenzgeber kann das Werk entweder als Quellcode oder als ausführbaren Code zur Verfügung stellen. Stellt er es als ausführbaren Code zur Verfügung, so stellt er zusätzlich eine maschinenlesbare Kopie des Quellcodes für jedes von ihm verbreitete Vervielfältigungsstück des Werks zur Verfügung, oder er verweist in einem Vermerk im Anschluss an den dem Werk beigefügten Urheberrechtshinweis auf einen Speicherort, an dem problemlos und unentgeltlich auf den Quellcode zugegriffen werden kann, solange der Lizenzgeber das Werk verbreitet oder zugänglich macht.
+
+## 4. Einschränkungen des Urheberrechts
+
+Durch diese Lizenz soll keinesfalls die Befugnis des Lizenznehmers eingeschränkt werden, die sich aus den Ausnahmen und Beschränkungen ergibt, die in den Ausschließlichkeitsrechten der Rechtsinhaber des Werks vorgesehen sind, oder die sich aus der Erschöpfung dieser Rechte oder anderen anwendbaren Einschränkungen ergibt.
+
+## 5. Pflichten des Lizenznehmers
+
+Die Einräumung der oben genannten Rechte ist an einige Beschränkungen und Pflichten für den Lizenznehmer gebunden:
+
+**Urheberrechtshinweis, Lizenzhinweis und Gewährleistungsausschluss**: Der Lizenznehmer muss alle Urheberrechts-, Patent- oder Markenhinweise und alle Hinweise auf die Lizenz und den Gewährleistungsausschluss unverändert lassen. Jedem von ihm verbreiteten oder zugänglich gemachten Vervielfältigungsstück des Werks muss der Lizenznehmer diese Hinweise sowie diese Lizenz beifügen. Der Lizenznehmer muss auf jedem abgeleiteten Werk deutlich darauf hinweisen, dass das Werk geändert wurde, und das Datum der Bearbeitung angeben.
+
+**Copyleft-Klausel**: Der Lizenznehmer darf Vervielfältigungen des Originalwerks oder Bearbeitungen nur unter den Bedingungen dieser EUPL oder einer neueren Version dieser EUPL verbreiten oder zugänglich machen, außer wenn das Originalwerk ausdrücklich nur unter dieser Lizenzversion – z. B. mit der Angabe „nur EUPL V. 1.2" – verbreitet wird. Der Lizenznehmer (der zum Lizenzgeber wird) darf für das Werk oder die Bearbeitung keine zusätzlichen Bedingungen anbieten oder vorschreiben, die die Bedingungen dieser Lizenz verändern oder einschränken.
+
+**Kompatibilitäts-Klausel**: Wenn der Lizenznehmer Bearbeitungen, die auf dem Werk und einem anderen Werk, das unter einer kompatiblen Lizenz lizenziert wurde, basieren, oder Kopien solcher Bearbeitungen verbreitet oder zugänglich macht, kann diese Verbreitung oder Zugänglichmachung unter den Bedingungen dieser kompatiblen Lizenz erfolgen. Unter „kompatibler Lizenz" ist eine im Anhang dieser Lizenz angeführte Lizenz zu verstehen. Sollten die Verpflichtungen des Lizenznehmers aus der kompatiblen Lizenz mit denjenigen aus der vorliegenden Lizenz (EUPL) in Konflikt stehen, werden die Verpflichtungen aus der kompatiblen Lizenz Vorrang haben.
+
+**Bereitstellung des Quellcodes**: Wenn der Lizenznehmer Vervielfältigungsstücke des Werks verbreitet oder zugänglich macht, muss er eine maschinenlesbare Fassung des Quellcodes mitliefern oder einen Speicherort angeben, über den dieser Quellcode problemlos und unentgeltlich so lange zugänglich ist, wie der Lizenznehmer das Werk verbreitet oder zugänglich macht.
+
+**Rechtsschutz**: Diese Lizenz erlaubt nicht die Benutzung von Kennzeichen, Marken oder geschützten Namensbezeichnungen des Lizenzgebers, soweit dies nicht für die angemessene und übliche Beschreibung der Herkunft des Werks und der inhaltlichen Wiedergabe des Urheberrechtshinweises erforderlich ist.
+
+## 6. Urheber und Bearbeiter
+
+Der ursprüngliche Lizenzgeber gewährleistet, dass er das Urheberrecht am Originalwerk innehat oder ihm dieses lizenziert wurde und dass er befugt ist, Lizenzen zu erteilen.
+
+Jeder Bearbeiter gewährleistet, dass er das Urheberrecht an den von ihm vorgenommenen Änderungen des Werks besitzt und befugt ist, Lizenzen daran zu erteilen.
+
+Jedes Mal, wenn Sie die Lizenz annehmen, erteilen Ihnen der ursprüngliche Lizenzgeber und alle folgenden Bearbeiter eine Befugnis zu ihren Beiträgen zum Werk unter den Bedingungen dieser Lizenz.
+
+## 7. Gewährleistungsausschluss
+
+Die Arbeit an diesem Werk wird laufend fortgeführt; es wird durch unzählige Bearbeiter kontinuierlich verbessert. Das Werk ist nicht vollendet und kann daher Fehler („bugs") enthalten, die dieser Art der Entwicklung inhärent sind.
+
+Aus den genannten Gründen wird das Werk unter dieser Lizenz „so, wie es ist" ohne jegliche Gewährleistung zur Verfügung gestellt. Dies gilt unter anderem – aber nicht ausschließlich – für Marktreife, Verwendbarkeit für einen bestimmten Zweck, Mängelfreiheit, Richtigkeit sowie Nichtverletzung von anderen Immaterialgüterrechten als dem Urheberrecht (vgl. dazu Artikel 6 dieser Lizenz).
+
+Dieser Gewährleistungsausschluss ist wesentlicher Bestandteil der Lizenz und Bedingung für die Einräumung jeglicher Nutzungsrechte am Werk.
+
+## 8. Haftungsausschluss/Haftungsbeschränkung
+
+Außer in Fällen von Vorsatz oder der Verursachung von Personenschäden haftet der Lizenzgeber nicht für direkte oder indirekte, materielle oder immaterielle Schäden irgendwelcher Art, die aus der Lizenz oder der Benutzung des Werks folgen; dies gilt unter anderem, aber nicht ausschließlich, für Firmenwertverluste, Produktionsausfall, Computerausfall oder Computerfehler, Datenverlust oder wirtschaftliche Schäden, und zwar auch dann, wenn der Lizenzgeber auf die Möglichkeit solcher Schäden hingewiesen wurde. Unabhängig davon haftet der Lizenzgeber im Rahmen der gesetzlichen Produkthaftung, soweit die entsprechenden Regelungen auf das Werk anwendbar sind.
+
+## 9. Zusatzvereinbarungen
+
+Wenn Sie das Werk verbreiten, können Sie Zusatzvereinbarungen schließen, in denen Verpflichtungen oder Dienstleistungen festgelegt werden, die mit dieser Lizenz vereinbar sind. Sie dürfen Verpflichtungen indessen nur in Ihrem eigenen Namen und auf Ihre eigene Verantwortung eingehen, nicht jedoch im Namen des ursprünglichen Lizenzgebers oder eines anderen Bearbeiters, und nur, wenn Sie sich gegenüber allen Bearbeitern verpflichten, sie zu entschädigen, zu verteidigen und von der Haftung freizustellen, falls aufgrund der von Ihnen eingegangenen Gewährleistungsverpflichtung oder Haftungsübernahme Forderungen gegen sie geltend gemacht werden oder eine Haftungsverpflichtung entsteht.
+
+## 10. Annahme der Lizenz
+
+Sie können den Bestimmungen dieser Lizenz zustimmen, indem Sie das Symbol „Lizenz annehmen" unter dem Fenster mit dem Lizenztext anklicken oder indem Sie Ihre Zustimmung auf vergleichbare Weise in einer nach anwendbarem Recht zulässigen Form geben. Durch Anklicken dieses Symbols geben Sie Ihre eindeutige und unwiderrufliche Annahme dieser Lizenz und aller ihrer Bedingungen und Bestimmungen zu erkennen.
+
+In gleicher Weise nehmen Sie diese Lizenz und alle ihre Bedingungen und Bestimmungen unwiderruflich an, wenn Sie ein Recht ausüben, das in Artikel 2 dieser Lizenz angeführt ist, wie das Erstellen von Bearbeitungen, das Vervielfältigen, Verbreiten oder Zugänglichmachen des Werks oder von Vervielfältigungen davon.
+
+## 11. Informationspflichten
+
+Wenn Sie das Werk verbreiten oder zugänglich machen (beispielsweise, indem Sie es zum Herunterladen von einer Website anbieten), müssen Sie über den Vertriebskanal oder das benutzte Medium der Öffentlichkeit zumindest jene Informationen bereitstellen, die nach dem anwendbaren Recht bezüglich der Lizenzgeber, der Lizenz und ihrer Zugänglichkeit, des Abschlusses des Lizenzvertrages sowie darüber, wie die Lizenz durch den Lizenznehmer gespeichert und vervielfältigt werden kann, erforderlich sind.
+
+## 12. Beendigung der Lizenz
+
+Die Lizenz und die durch sie eingeräumten Rechte erlöschen automatisch, wenn der Lizenznehmer gegen die Lizenzbedingungen verstößt.
+
+Ein solches Erlöschen beendet nicht die Lizenzen von Personen, denen das Werk vom Lizenznehmer unter dieser Lizenz zur Verfügung gestellt worden ist, solange diese Personen die Lizenzbedingungen erfüllen.
+
+## 13. Sonstiges
+
+Unbeschadet des Artikels 9 stellt die Lizenz die vollständige Vereinbarung der Parteien über das Werk dar.
+
+Sind einzelne Bestimmungen der Lizenz nach geltendem Recht nichtig oder nicht durchsetzbar, so berührt dies nicht die Wirksamkeit oder Durchsetzbarkeit der Lizenz an sich. Solche Bestimmungen werden in dem kleinsten erforderlichen Umfang so ausgelegt oder modifiziert, dass sie wirksam und durchsetzbar sind.
+
+Die Europäische Kommission kann weitere Sprachfassungen oder neue Versionen dieser Lizenz oder aktualisierte Fassungen des Anhangs veröffentlichen, soweit dies notwendig und angemessen ist, ohne den Umfang der Lizenzrechte zu schmälern. Neue Versionen werden mit einer eindeutigen Versionsnummer veröffentlicht.
+
+Alle von der Europäischen Kommission anerkannten Sprachfassungen dieser Lizenz sind gleichwertig. Die Parteien können sich auf die Sprachfassung ihrer Wahl berufen.
+
+## 14. Gerichtsstand
+
+Unbeschadet besonderer Vereinbarungen zwischen den Parteien gilt Folgendes:
+
+- Für alle Streitigkeiten über die Auslegung dieser Lizenz zwischen den Organen, Einrichtungen und sonstigen Stellen der Europäischen Union als Lizenzgeber und einem Lizenznehmer ist der Gerichtshof der Europäischen Union gemäß Artikel 272 des Vertrags über die Arbeitsweise der Europäischen Union zuständig.
+- Gerichtsstand für alle Streitigkeiten zwischen anderen Parteien über die Auslegung dieser Lizenz ist allein der Ort, an dem der Lizenzgeber seinen Wohnsitz oder den wirtschaftlichen Mittelpunkt seiner Tätigkeit hat.
+
+## 15. Anwendbares Recht
+
+Unbeschadet besonderer Vereinbarungen zwischen den Parteien gilt Folgendes:
+
+- Diese Lizenz unterliegt dem Recht des Mitgliedstaats der Europäischen Union, in dem der Lizenzgeber seinen Sitz oder Wohnsitz oder seinen eingetragenen Sitz hat.
+- Diese Lizenz unterliegt dem belgischen Recht, wenn der Lizenzgeber keinen Sitz oder Wohnsitz oder eingetragenen Sitz in einem Mitgliedstaat der Europäischen Union hat.
+
+## Anhang
+
+„Kompatible Lizenzen" nach Artikel 5 EUPL sind:
+
+- GNU General Public License (GPL) v. 2, v. 3
+- GNU Affero General Public License (AGPL) v. 3
+- Open Software License (OSL) v. 2.1, v. 3.0
+- Eclipse Public License (EPL) v. 1.0
+- CeCILL v. 2.0, v. 2.1
+- Mozilla Public Licence (MPL) v. 2
+- GNU Lesser General Public Licence (LGPL) v. 2.1, v. 3
+- Creative Commons Attribution-ShareAlike v. 3.0 Unported (CC BY-SA 3.0) nur für Werke, die keine Software sind
+- European Union Public Licence (EUPL) v. 1.1, v. 1.2
+- Québec Free and Open-Source Licence — Reciprocity (LiLiQ-R) oder Strong Reciprocity (LiLiQ-R+)
+
+Die Europäische Kommission kann diesen Anhang aktualisieren, um neuere Versionen der genannten Lizenzen aufzunehmen, ohne eine neue Fassung der EUPL herauszugeben, solange diese Versionen die in Artikel 2 gewährten Rechte gewähren und den erfassten Quellcode vor ausschließlicher Aneignung schützen.
+
+Alle sonstigen Änderungen oder Ergänzungen dieses Anhangs bedürfen einer neuen EUPL-Version.

mkdocs_kern_ux-0.2.0/PKG-INFO

@@ -0,0 +1,319 @@
+Metadata-Version: 2.5
+Name: mkdocs-kern-ux
+Version: 0.2.0
+Summary: MkDocs-Theme auf Basis des KERN-UX Design-Systems (@kern-ux/native).
+Project-URL: Homepage, https://kern-ux.de
+Project-URL: Documentation, https://kern-ux-theme-for-mkdocs-fda32d.usercontent.opencode.de/
+Project-URL: Source, https://gitlab.opencode.de/sgemlichheim/kern-ux-theme-for-mkdocs
+Project-URL: Issues, https://gitlab.opencode.de/sgemlichheim/kern-ux-theme-for-mkdocs/-/issues
+Author: Samtgemeinde Emlichheim, Michi91
+License-Expression: EUPL-1.2
+License-File: LICENSE
+License-File: THIRD-PARTY.md
+Keywords: accessibility,barrierefreiheit,bitv,kern,kern-ux,mkdocs,mkdocs-theme
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: MkDocs
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: German
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Documentation
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.9
+Requires-Dist: mkdocs<2,>=1.6
+Provides-Extra: recommended
+Requires-Dist: pygments>=2.16; extra == 'recommended'
+Requires-Dist: pymdown-extensions>=10.0; extra == 'recommended'
+Description-Content-Type: text/markdown
+
+# mkdocs-kern-ux
+
+MkDocs-Theme auf Basis des [KERN Design-Systems](https://www.kern-ux.de) – dem
+offenen Design-System für die öffentliche Verwaltung, initiiert von Hamburg und
+Schleswig-Holstein.
+
+Das Theme ist die Nachnutzung dieses Systems durch eine Kommune, **kein
+offizielles Angebot des KERN-Projekts**. Es ist das Schwesterprojekt des
+[KERN-UX-Themes für WordPress](https://gitlab.opencode.de/sgemlichheim/kern-ux-theme-for-wordpress)
+und folgt demselben Bauprinzip.
+
+**Demo:** <https://kern-ux-theme-for-mkdocs-fda32d.usercontent.opencode.de/>
+
+## Grundidee: Vendor und Bridge
+
+| Schicht | Inhalt | Wer pflegt sie |
+| ------- | ------ | -------------- |
+| **Vendor** | Der komplette KERN-Kit (`@kern-ux/native`) und highlight.js, unverändert unter `src/mkdocs_kern_ux/kern-ux/vendor/` | Upstream; Aktualisierung mit `npm run vendor:update` |
+| **Bridge** | Templates, `kern-ux/css/kern-ux.css`, `kern-ux/js/*.js` | dieses Repository |
+
+Die Bridge enthält **keine eigenen Designwerte**. Sie referenziert
+ausschließlich KERN-Token (`--kern-*`) und übersetzt das von MkDocs und
+Python-Markdown erzeugte Markup darauf. Deshalb wirken heller und dunkler Modus
+sowie künftige KERN-Updates automatisch, und ein Kit-Update bleibt konfliktfrei.
+
+Anpassungen gehören nie in den Vendor-Ordner – er wird bei jedem Sync
+vollständig ersetzt.
+
+## Installation
+
+```bash
+pip install mkdocs-kern-ux
+```
+
+```yaml
+# mkdocs.yml
+theme:
+  name: kern-ux
+```
+
+Mehr braucht es nicht: Schriften, Stylesheets und Skripte liegen im Paket und
+werden beim Bauen in die Site kopiert. **Es wird kein CDN kontaktiert** – für
+Angebote der öffentlichen Verwaltung ist das eine Anforderung, keine Zugabe.
+
+### Empfohlene Erweiterungen
+
+```yaml
+markdown_extensions:
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - fenced_code
+  - footnotes
+  - md_in_html
+  - tables
+  - toc:
+      permalink: true
+  - pymdownx.details      # aufklappbare Hinweise (???)
+  - pymdownx.mark         # ==Hervorhebung==
+  - pymdownx.tilde        # ~~durchgestrichen~~
+  - pymdownx.tasklist:
+      custom_checkbox: false
+
+plugins:
+  - search:
+      lang: de
+```
+
+Die `pymdownx.*`-Erweiterungen stammen aus `pymdown-extensions`
+(`pip install "mkdocs-kern-ux[recommended]"`). Das Theme läuft auch ohne sie –
+die Bridge deckt beide Ausgabeformen ab.
+
+## Optionen
+
+Wo die mitgelieferten Themes `mkdocs` und `readthedocs` bereits eine Option
+kennen, trägt sie hier denselben Namen und dieselbe Bedeutung.
+
+### Kompatibel zu den mitgelieferten Themes
+
+| Option | Vorgabe | Bedeutung |
+| ------ | ------- | --------- |
+| `highlightjs` | `true` | Syntaxhervorhebung mit highlight.js (lokal) |
+| `hljs_languages` | `[]` | Zusatzsprachen, z. B. `[rust, php]` |
+| `hljs_style` | `github` | Farbschema hell |
+| `hljs_style_dark` | `github-dark` | Farbschema dunkel |
+| `analytics.gtag` | `null` | Google-Analytics-Kennung (siehe Hinweis unten) |
+| `analytics.anonymize_ip` | `false` | IP-Anonymisierung an gtag durchreichen |
+| `include_homepage_in_sidebar` | `true` | Startseite in der Seitenleiste zeigen |
+| `prev_next_buttons_location` | `bottom` | `top`, `bottom`, `both`, `none` |
+| `navigation_depth` | `4` | Tiefe des Navigationsbaums |
+| `titles_only` | `true` | `false` zeigt die Gliederung der aktiven Seite in der Seitenleiste |
+| `sticky_navigation` | `true` | Seitenleiste und Gliederung laufen mit |
+| `collapse_navigation` | `true` | Nur der aktive Abschnitt ist aufgeklappt |
+| `logo` | `null` | Logo, relativ zu `docs_dir` |
+| `color_mode` | `auto` | `auto`, `light`, `dark` |
+| `user_color_mode_toggle` | `true` | Umschalter in der Kopfzeile |
+| `include_search_page` | `true` | Seite `search.html` erzeugen |
+| `search_index_only` | `false` | Nur den Suchindex schreiben |
+| `locale` | `de` | Sprache der Seite und Stemming der Suche |
+
+Nicht übernommen: `nav_style` und `shortcuts` aus dem `mkdocs`-Theme. KERN kennt
+keine Navbar-Varianten, und Tastaturkürzel ohne sichtbare Erklärung schaffen
+mehr Verwirrung als Nutzen.
+
+### Eigene Optionen
+
+| Option | Vorgabe | Bedeutung |
+| ------ | ------- | --------- |
+| `show_toc` | `true` | Gliederungsspalte rechts |
+| `toc_depth` | `3` | Tiefste Überschriftenebene in der Gliederung |
+| `toc_scrollspy` | `true` | Sichtbaren Abschnitt markieren |
+| `show_breadcrumb` | `true` | Brotkrumenpfad |
+| `show_edit_link` | `true` | „Diese Seite bearbeiten“ (braucht `repo_url` + `edit_uri`) |
+| `show_search` | `true` | Suchknopf in der Kopfzeile |
+| `copy_code` | `true` | Kopierknopf an Codeblöcken |
+| `admonition_icons` | `true` | KERN-Symbole in Hinweisen |
+| `content_width` | `50rem` | Lesebreite des Fließtexts |
+| `max_width` | `90rem` | Gesamtbreite der Seite |
+| `logo_alt` | `''` | Alternativtext des Logos; leer = dekorativ |
+| `favicon` | `null` | Favicon, relativ zu `docs_dir` |
+| `homepage_title` | `null` | Beschriftung der Startseite im Brotkrumenpfad |
+| `footer_text` | `''` | Freier Text in der Fußzeile |
+| `footer_links` | `[]` | Einträge `{text, href, external}`; `href` darf auf die Quelldatei zeigen (`impressum.md`) oder eine fertige Adresse sein |
+| `show_kern_credit` | `true` | Hinweis auf KERN und die Kit-Version |
+
+### Texte
+
+Jeder sichtbare Text ist einzeln überschreibbar; die Schlüssel beginnen mit
+`lang_` (siehe `src/mkdocs_kern_ux/mkdocs_theme.yml`):
+
+```yaml
+theme:
+  name: kern-ux
+  lang_search: Volltextsuche
+  lang_edit: Seite im Repository bearbeiten
+```
+
+Die Schlüssel sind bewusst flach: MkDocs ersetzt ein Mapping vollständig, ein
+einzelner Override würde in einer verschachtelten Struktur alle übrigen Texte
+löschen.
+
+## Eigene Anpassungen
+
+```yaml
+theme:
+  name: kern-ux
+  custom_dir: overrides
+
+extra_css:
+  - assets/eigene.css
+```
+
+```jinja
+{# overrides/main.html #}
+{% extends "base.html" %}
+
+{% block footer %}
+  <footer class="kux-footer">…</footer>
+{% endblock %}
+```
+
+Verfügbare Blöcke: `site_meta`, `htmltitle`, `styles`, `libs`, `analytics`,
+`extrahead`, `body_class`, `header`, `site_name`, `search_button`, `site_nav`,
+`content`, `repo`, `next_prev`, `toc`, `footer`, `search_dialog`, `scripts`.
+
+Alle Optionen stehen in den Templates als `kux.<option>` bereit – nicht als
+`config.theme.<option>`. `base.html` mischt die Vorgaben dort noch einmal
+selbst, damit das Theme auch als reines `custom_dir` vollständig funktioniert.
+
+### Als custom_dir ohne Paketinstallation
+
+```yaml
+theme:
+  name: null
+  custom_dir: pfad/zu/src/mkdocs_kern_ux
+  # In dieser Betriebsart liest MkDocs mkdocs_theme.yml nicht - diese vier
+  # Vertragsschluessel muessen deshalb selbst gesetzt werden:
+  locale: de
+  static_templates: [404.html]
+  include_search_page: true
+  search_index_only: false
+```
+
+Alle übrigen Optionen greifen auch hier auf ihre Vorgaben zurück; die gebauten
+Seiten sind Zeichen für Zeichen identisch mit der Paketinstallation.
+
+## Aktualisieren
+
+```bash
+npm run kern:check      # gibt es eine neuere KERN-Version?
+npm run kern:update     # KERN installieren und ins Theme kopieren
+npm run hljs:update     # highlight.js aktualisieren
+npm run vendor:update   # beides
+```
+
+Die Sync-Skripte ersetzen den Vendor-Ordner vollständig, schreiben `VERSION`
+und `SYNC.txt`, kopieren die Lizenztexte zusätzlich als `.txt` und ziehen
+`kern_version` bzw. `hljs_version` in `mkdocs_theme.yml` nach. Bricht ein
+Update, weil eine erwartete Datei fehlt, meldet das Skript das laut, statt
+still 404er auszuliefern.
+
+Nach einem Update lohnt ein Blick auf `demo/docs/komponenten/tabellen.md`: dort
+stehen Markdown-Tabelle und handgeschriebene `kern-table` untereinander, sodass
+ein geändertes Kit-Design sofort auffällt.
+
+Mit `npm run kern:sync:prune` bzw. `hljs:sync:prune` lässt sich der Vendor auf
+das tatsächlich Geladene eindampfen (rund 8 MB → 2 MB). Voreingestellt ist die
+vollständige, unveränderte Kopie.
+
+## Demo
+
+**Online:** <https://kern-ux-theme-for-mkdocs-fda32d.usercontent.opencode.de/> – wird bei jedem Push auf `main` von der CI neu gebaut.
+
+Ein fertiger Offline-Export liegt unter `demo/export/` – `index.html` einfach
+im Browser öffnen. Selbst bauen und live anschauen:
+
+```bash
+npm install && npm run vendor:sync   # nur nötig, um den Vendor zu erneuern
+pip install -e ".[recommended]"
+mkdocs serve -f demo/mkdocs.yml
+```
+
+`demo/mkdocs.minimal.yml` baut dieselbe Site ohne `pymdown-extensions` und mit
+serverseitiger Hervorhebung (`codehilite`). Beide Profile zu bauen ist der
+Regressionstest der Bridge:
+
+```bash
+mkdocs build --strict -f demo/mkdocs.yml
+mkdocs build --strict -f demo/mkdocs.minimal.yml
+mkdocs build -f demo/mkdocs.export.yml   # Offline-Export nach demo/export/
+```
+
+Dazu ein Prüflauf im echten Browser – er misst die Layout-Geometrie jeder
+Demoseite und bedient Suche, Kopierknopf und Design-Umschalter:
+
+```bash
+npm run demo:serve     # in einem Terminal
+npm run demo:check     # im zweiten
+```
+
+Weicht eine Seite ab, greift Inhalt ins Seitenlayout durch. Genau das passiert
+zum Beispiel, wenn der Seitenrahmen `kern-container` trägt und eine Seite ein
+`kern-grid` enthält.
+
+## Stolperfallen
+
+**`code { font-family: … }` in eigenem CSS wirkt nicht.** Der KERN-Kit setzt
+`*:not(i) { font-family: … }`. Diese Regel schlägt einen bloßen
+Elementselektor. Schreiben Sie `.kux-prose code { … }`.
+
+**Serverseitige Hervorhebung und highlight.js schließen sich aus.** Wer
+`codehilite` oder `pymdownx.highlight` nutzt, färbt bereits beim Bauen; dann
+`highlightjs: false` setzen und ein Pygments-Stylesheet über `extra_css`
+einbinden. Das Theme lässt vorgefärbte Blöcke unangetastet.
+
+**`edit_uri` bei selbst gehostetem GitLab.** MkDocs leitet die Bearbeiten-URL
+nur für github.com, gitlab.com und bitbucket.org automatisch ab. Für
+openCoDE/GitLab: `edit_uri: -/edit/main/docs/`.
+
+**Schriftanzeige.** Der Kit liefert keine `font-display`-Angabe. Das Theme lädt
+die beiden genutzten Schnitte deshalb vorab (`rel=preload`).
+
+**`analytics.gtag` bindet ein Skript von Google ein.** Voreingestellt ist die
+Option leer. Wer sie setzt, braucht eine eigene Rechtsgrundlage und muss die
+Datenschutzerklärung ergänzen.
+
+**Browser-Untergrenze.** Der Suchdialog nutzt `<dialog>.showModal()`; fehlt die
+Unterstützung, führt der Suchknopf zur Seite `search.html`. Die Bridge nutzt
+`:is()` – seit 2021 überall verfügbar.
+
+## Barrierefreiheit
+
+Sprunglink, Landmarken, sichtbarer Fokus (4 px, aus dem Kit), Zustände nie nur
+über Farbe, scrollbare Codeblöcke mit Tastaturzugang, fokussierbare Ankerlinks,
+Berücksichtigung von `forced-colors` und `prefers-reduced-motion`, und ohne
+JavaScript bleibt alles bedienbar. Details:
+`demo/docs/referenz/barrierefreiheit.md`.
+
+## Veröffentlichen
+
+Wie das Theme gebaut, weitergegeben und auf PyPI veröffentlicht wird, steht
+Schritt für Schritt in [VEROEFFENTLICHEN.md](VEROEFFENTLICHEN.md) – ohne
+Python-Vorwissen lesbar.
+
+## Lizenz
+
+Der Theme-Code steht unter der **EUPL-1.2** (siehe `LICENSE`). Der gebündelte
+KERN-Kit steht ebenfalls unter EUPL-1.2, highlight.js unter BSD 3-Clause, die
+Schriften unter der SIL Open Font License 1.1 – siehe `THIRD-PARTY.md`.