v0.10.1 - GitHub-Überschriften-IDs, Codeblock-Parsing & Link-Fixes
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 SeiteheadingIds: 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 vonlite-mdxauf0.1.2mit 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-mdxdie 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 --mkdocsbeendet das Parsen der Navigation nun am nächsten YAML-Schlüssel der obersten Ebene (verhindert, dassplugins:undmarkdown_extensions:in die Seitenleiste aufgenommen werden), entfernt Anführungszeichen in Titeln/Pfaden und ordnetindex.mdkorrekt den Ordnerrouten zu. Beigesteuert von @jayhemnani9910 in #285. - Dynamische Versionsprüfung: Testbehauptung in
tests/cli-contracts/variables-engine.test.jsauf dynamische Prüfung gegenregistry.get('docmd.version')aktualisiert.
Documentation & Diagnostics
- Leitfäden für Überschriften-IDs & Link-Normalisierung: Konfigurations- und Frontmatter-Referenzdokumentation für
markdown.headingIdshinzugefü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) unterplugins/iconify.mdhinzugefügt. - Verschachtelte Codeblöcke: Escaping verschachtelter Code-Fences im Tabs-Beispiel mit 4 Backticks und umschließender
::: tabs-Containersyntax korrigiert.
Links
Dokumentation: https://docs.docmd.io/
Cloud-Plattform: https://cloud.docmd.io/
Entwickler- & Schreib-Skills: https://github.com/docmd-io/docmd-skills
New Contributors
- @jayhemnani9910 hat den ersten Beitrag in https://github.com/docmd-io/docmd/pull/285 geleistet
Vollständiges Changelog: https://github.com/docmd-io/docmd/compare/0.10.0...0.10.1