v0.10.1 - GitHub-Überschriften-IDs, Codeblock-Parsing & Link-Fixes

GitHub-Überschriften-IDs, Codeblock-Parsing & Link-Fixes

v0.10.1 führt Unterstützung für GitHub-kompatible flache Überschriften-IDs ein und behebt die Codeblock-Erhaltung bei der MDX-Kompilierung, die interne Link-Normalisierung für Dateinamen mit Punkten und Abfrageparametern sowie Verbesserungen beim Parsen der Seitenleiste im MkDocs-Migrationswerkzeug.

Added

  • GitHub-kompatible flache Überschriften-IDs (@docmd/parser): Option "markdown": { "headingIds": "github" } (oder Frontmatter pro Seite headingIds: github) hinzugefügt, um flache Überschriften-IDs nach GitHubs Slug-Konvention zu generieren (Kleinbuchstaben, Entfernung von Satzzeichen ohne Zusammenfassung von Bindestrichen, Leerzeichen zu Bindestrichen sowie -1-, -2-Suffixe bei doppelten Überschriften auf einer Seite). Standardmäßig behält docmd die bisherigen hierarchischen kontextbezogenen Überschriften-IDs ("nested") bei. Vorgeschlagen von @thinkbig1979 in #286.

Fixed

  • Codeblock-Ausdrucksauswertung behoben (@docmd/plugin-mdx, lite-mdx): Aktualisierung von lite-mdx auf 0.1.2 mit robustem CommonMark-konformen Fence-Scanning. Codeblöcke mit Anführungszeichen, Titeln oder Attributen (wie ```json "docmd.config.json") sind nun strikt vor JSX/MDX-Kompilierung geschützt. Zusätzlich führt @docmd/plugin-mdx die MDX-Verarbeitung auf .md-Dateien nur noch aus, wenn tatsächliche JSX-Syntax oder Imports/Exports vorhanden sind.
  • Interne Links mit Punkten & Abfrage-Strings (@docmd/parser): Problem behoben, bei dem Links zu Markdown-Seiten mit Punkten im Dateinamen (z. B. release-1.0.md, docmd.config.md) fälschlicherweise als statische Rohdateien eingestuft wurden, wodurch abschließende Schrägstriche und Unterseiten-../-Tiefenverschiebungen übersprungen wurden. Query-Strings (z. B. other.md?tab=npm, index.md?tab=npm) werden nun vor der Erweiterungsentfernung separiert und bei relativen Pfadverschiebungen beibehalten. Behebt #284.
  • MkDocs-Navigationsmigration (@docmd/core): docmd migrate --mkdocs beendet das Parsen der Navigation nun am nächsten YAML-Schlüssel der obersten Ebene (verhindert, dass plugins: und markdown_extensions: in die Seitenleiste aufgenommen werden), entfernt Anführungszeichen in Titeln/Pfaden und ordnet index.md korrekt den Ordnerrouten zu. Beigesteuert von @jayhemnani9910 in #285.
  • Dynamische Versionsprüfung: Testbehauptung in tests/cli-contracts/variables-engine.test.js auf dynamische Prüfung gegen registry.get('docmd.version') aktualisiert.

Documentation & Diagnostics

  • Leitfäden für Überschriften-IDs & Link-Normalisierung: Konfigurations- und Frontmatter-Referenzdokumentation für markdown.headingIds hinzugefügt und Link-Erhaltung für Dateinamen mit Punkten und Abfrageparametern in allen vier Sprachen dokumentiert.
  • Iconify-Plugin-Dokumentation: Spezifische Dokumentation und interaktive Live-Container-Beispiele (Callouts, Buttons, Karten, Tabs, Tags) in allen vier Sprachen (en, de, es, zh) unter plugins/iconify.md hinzugefügt.
  • Verschachtelte Codeblöcke: Escaping verschachtelter Code-Fences im Tabs-Beispiel mit 4 Backticks und umschließender ::: tabs-Containersyntax korrigiert.

Dokumentation: https://docs.docmd.io/
Cloud-Plattform: https://cloud.docmd.io/
Entwickler- & Schreib-Skills: https://github.com/docmd-io/docmd-skills

New Contributors

Vollständiges Changelog: https://github.com/docmd-io/docmd/compare/0.10.0...0.10.1