Referenz der integrierten Variablen

Referenz der integrierten Variablen

docmd registriert bei jedem Build automatisch eine Reihe integrierter Variablen. Diese Variablen erfordern keinerlei Konfiguration und stehen sofort in Markdown-Dateien, Bannern, Fußzeilen und Metatags zur Verfügung.

System- & Build-Variablen

Variable Alias Beispielwert Beschreibung
docmd.version DOCMD_VERSION 0.9.9 Die aktuelle Compiler-Version von docmd.
docmd.buildYear BUILD_YEAR 2026 Das 4-stellige Kalenderjahr des aktuellen Builds.
docmd.buildDate BUILD_DATE 2026-10-31 Das ISO-Datum (JJJJ-MM-TT) des Builds.
docmd.buildTime BUILD_TIME 2026-10-31T10:50:00Z Der vollständige ISO-8601 UTC-Zeitstempel.
Live ausgewertete System-Variablen

Diese Werte werden in diesem Dokumentations-Build live bereitgestellt:

  • Compiler-Version: v0.10.1
  • Kalenderjahr: 2026
  • Build-Zeitstempel: 2026-11-16T18:04:14.810Z

Verwenden Sie {{ docmd.buildYear }} in Ihrer docmd.config.json, damit das Copyright-Jahr bei jedem Deployment aktuell bleibt:

{
  "footer": {
    "copyright": "Copyright © {{ docmd.buildYear }} Acme Technologies. Alle Rechte vorbehalten."
  }
}

Git- & Repository-Metadaten

Befindet sich das Projekt in einem Git-Repository, extrahiert docmd Versionskontroll-Metadaten:

Variable Alias Beispielwert Beschreibung
docmd.gitCommit git.commit, GIT_COMMIT 7a9b1c2 Der 7-stellige Kurz-SHA des aktuellen Git-Commits.
docmd.gitBranch git.branch, GIT_BRANCH main Der Name des aktuell aktiven Git-Branches.

Commit-Informationen in Markdown einbinden

Nutzen Sie die Template-Syntax in Markdown-Dateien:

> Diese Dokumentation wurde aus Commit `{{ docmd.gitCommit }}` auf Branch `{{ docmd.gitBranch }}` am {{ docmd.buildDate }} generiert.
Live Git-Metadaten

Diese Dokumentationsseite wurde aus Commit f8f75b6 auf Branch main am 2026-11-16 erstellt.

Site- & Seiten-Kontextvariablen

docmd stellt kontextbezogene Variablen für das Projekt und das aktuell verarbeitete Dokument bereit:

Variable Beispielwert Beschreibung
site.title docmd docs Der in docmd.config.json konfigurierte Site-Titel.
site.base / Der konfigurierte Basis-URL-Pfad.
page.title Referenz der integrierten Variablen Der Titel der aktuellen Seite (aus Frontmatter oder Überschrift).
page.slug variables/built-in-variables Der relative URL-Pfad der aktuellen Seite ohne Dateiendung.
page.path variables/built-in-variables.md Der relative Dateipfad der Quell-Markdown-Datei.

Dynamischer Header-Kontext

# Willkommen bei {{ site.title }}

Sie betrachten derzeit **{{ page.title }}** (`{{ page.slug }}`).
Aktueller Seitenkontext
  • Seitentitel: Referenz der integrierten Variablen
  • Seiten-Slug: variables/built-in-variables
  • Dateipfad: /de/09/variables/built-in-variables/
  • Site-Titel: docmd docs
  • Site-Basis: /
Verwendung in Konfigurationsfeldern

Alle integrierten Variablen können direkt in Feldern wie layout.banners.top.content oder footer.copyright referenziert werden.