Frontmatter

Content speichert nur, was das Schema einer Collection deklariert — dies ist also die vollständige Liste: Ein nicht deklariertes Feld wird stillschweigend verworfen, bevor die Seitenleiste oder die Suche es je sieht.

#Was du schreibst

title und description sind die beiden, vor deren Fehlen der Build warnt. Keines bricht eine Seite, und beide verschlechtern still das Inhaltsverzeichnis, die Social Card und llms.txt.

#Die Schalter der Seite

Acht weitere Felder, von denen jedes ein Stück dessen abschaltet, was duxt um eine Seite herum zeichnet. Mit ihnen sagt eine Seite, wofür sie da ist: eine API-Referenz, die die volle Breite will, eine Rechtstext-Seite ohne „War diese Seite hilfreich?“, eine Rumpfseite, die nicht in der Suche auftauchen soll.

---
title: Nutzungsbedingungen
feedback: false
prevNext: false
search: false
---

Sie lassen sich kombinieren, und keines zieht ein anderes nach sich. fullWidth: true entfernt das Lesemaß und sonst nichts — die Inhaltsspalte und der Herkunftsblock bleiben, solange nicht auch die abgeschaltet werden — und copyPage: false lässt den Herkunftsblock in Ruhe. Eine Seite, die keines davon setzt, sieht genau so aus wie eh und je.

breadcrumb ist das eine mit einem seitenweiten Schalter dahinter, duxt.breadcrumb. Die Seite gewinnt überall dort, wo sie sich äußert; eine Website, die die Spur überall verborgen hat, kann sie also auf der einen Seite zurückholen, auf der die Spur der Punkt ist.

#Wie tief das Inhaltsverzeichnis reicht

toc: false lässt die Spalte weg. Die Objektform setzt die tiefste Überschrift, die es auflistet, geschrieben als Überschriftenebene — die Liste beginnt immer bei h2, und h3 ist der Standard.

---
title: Konfiguration
toc:
  maxDepth: 4
---

maxDepth nimmt 2 bis 6. Alles andere fällt auf den Standard zurück, statt die Spalte zu leeren: Es gibt kein h7, und h1 ist der Titel.

#Was search: false tut, und was nicht

Es nimmt die Seite von jeder Oberfläche, die duxt zum Finden von etwas anbietet: dem Suchdialog, seinem Rückfall auf Beinahetreffer, dem MCP-Werkzeug search_docs sowie llms.txt und llms-full.txt.

Es ändert nichts an der Adresse der Seite. Die URL, das Canonical, der Sitemap-Eintrag und die robots-Metadaten bleiben unberührt, die Seite rendert wie eh und je, und MCPs read_page antwortet weiterhin für sie. Die Seite wird unauffindbar, nicht unveröffentlicht. Um eine Seite stattdessen aus dem Navigationsbaum zu halten, ist das navigation: false; um sie aus einer Suchmaschine zu halten, ist das Sache des Crawlers und nicht dieses Feldes.

#Was der Build füllt

Eines davon von Hand zu schreiben ist zwecklos: Der Build überschreibt sie. Beide git-Felder brauchen eine echte Historie, eine entfernte Quelle braucht also history: true — siehe Quellen-Referenz.

#Der Dateiname trägt zwei weitere Dinge

• Ein numerisches Präfix ordnet den Baum und wird aus der URL entfernt: 3.guides/2.deploy.md wird unter /guides/deploy ausgeliefert. Umsortieren verschiebt nie eine URL.
• .draft.md ist ein Entwurf. Er wird im Entwicklungsserver ausgeliefert und fehlt im Build. Es gibt kein draft: true, weil der Inhalt einer Collection deklariert wird, bevor irgendeine Datei gelesen wurde — siehe Collections.