Die Datei docmd.config.json ist die zentrale Konfiguration für Ihren Workspace. Sie steuert das Styling der Website, die Sidebar-Hierarchien, Lokalisierungsdetails und Compiler-Optionen.

1. Das Konfigurationsschema

JSON ist das Standard-Konfigurationsformat. Dies ermöglicht eine hochperformante Serialisierung über die Worker-Pools der Engine.

Jedoch werden docmd.config.js und docmd.config.ts weiterhin vollständig unterstützt, falls Sie dynamische JavaScript-Logik benötigen.

{
  "title": "Mein Projekt",
  "url": "https://docs.myproject.com",
  "src": "docs",
  "out": "site",
  "base": "/"
}

2. Kerneinstellungen

Diese Parameter auf oberster Ebene konfigurieren die Basis-Eingaben und -Ziele des Compilers.

3. Branding & Identität

Verwalten Sie, wie Ihre Marke im Header und in den Browser-Tabs erscheint.

{
  "logo": {
    "light": "assets/images/logo-dark.png",
    "dark": "assets/images/logo-light.png",
    "href": "/",
    "alt": "Firmenlogo",
    "height": "32px"
  },
  "favicon": "assets/favicon.ico"
}

4. UI-Layout & Verhalten

Die Engine bietet ein modulares Header- und Sidebar-Layout. Passen Sie funktionale Bereiche an. Ändern Sie die Sichtbarkeit von Komponenten wie Suche und Dark-Mode-Umschalter. Aktivieren oder deaktivieren Sie Breadcrumbs.

{
  "layout": {
    "spa": true,
    "header": {
      "enabled": true
    },
    "sidebar": {
      "collapsible": true,
      "defaultCollapsed": false
    },
    "optionsMenu": {
      "position": "header",
      "components": {
        "search": true,
        "themeSwitch": true
      }
    }
  }
}

Siehe den Leitfaden Layout & UI-Zonen für alle Optionen zur visuellen Anpassung.

5. Kernfunktionen der Engine

Feinabstimmung, wie der Parser Ihre Inhaltsdateien verarbeitet.

{
  "minify": true,
  "autoTitleFromH1": true,
  "copyCode": true,
  "pageNavigation": true,
  "markdown": {
    "breaks": true
  }
}