Eine Dokumentationsseite hinzufügen

Erstellen Sie .md oder .mdx unter apps/web/content/docs/. Halten Sie verwandte Seiten in vorhandenen Themenordnern; der Dateiname wird zum Slug und index zur Ordnerwurzel.

Frontmatter und Navigation

Jede Seite braucht title; subtitle erscheint darunter und wird für die Metadaten dieser Route genutzt. Das Schema in apps/web/modules/docs/source.ts erweitert Fumadocs pageSchema um dieses Feld.

---
title: Webhooks für Abrechnung
subtitle: Wie signierte Ereignisse ein Team-Abonnement aktualisieren
---

Ergänzen Sie den Slug in pages der nächsten meta.json, um die Seitenleistenreihenfolge festzulegen. Aktualisieren Sie auch meta.de.json. Halten Sie die Wurzelgruppen in apps/web/content/docs/meta.json mit der lokalisierten Datei synchron.

Übersetzungsabdeckung

Englisch nutzt Dateien ohne Suffix, Deutsch Punkt-Suffixe wie overview.de.mdx. Beide sind gepflegte Dokumentationssprachen. Andere konfigurierte UI-Sprachen nutzen derzeit den Fallback auf die Standardsprache. Übersetzen Sie neue englische Seiten ins Deutsche und erhalten Sie Beispiele, Befehle, Links und Warnungen. Erstellen Sie keine unübersetzten Kopien für weitere Sprachcodes.

Die Route liest NEXT_LOCALE; öffentliche Seiten-URLs bleiben flach. Lesen Sie Neue Sprache hinzufügen, bevor Sie die Sprachabdeckung erweitern.

Komponenten und Prüfungen

Verwenden Sie Komponenten aus apps/web/modules/docs/mdx-components.tsx, etwa Callout, Cards, Steps und Step. Registrieren Sie eigene Komponenten dort, bevor Inhalte sie verwenden.

bun run agent:i18n --strict
bun run build

Starten Sie die Vorschau mit bun run dev und öffnen Sie /docs. Prüfen Sie Seite, lokalisierte Navigation und Fallback. Framework-spezifische Funktionen beschreibt die offizielle Fumadocs-Dokumentation.