Theme-Konfiguration
Diese Referenz wird automatisch aus den Theme-Typdefinitionen und Default-Werten generiert.
| Eigenschaft | Typ | Erforderlich | Default | Beschreibung |
|---|---|---|---|---|
| matomo | { url: string; siteId: string; privacyUrl: string; } | false | — | Optionale Konfiguration für consent-basiertes Matomo-Tracking. |
| matomo.url | string | true | — | Basis-URL der Matomo-Instanz. |
| matomo.siteId | string | true | — | Matomo-Site-ID. |
| matomo.privacyUrl | string | true | — | URL oder Pfad zur Datenschutzerklärung. |
| glossaryPage | string | false | — | URL-Pfad zur Glossar-Seite (z. B. /glossar). Aktiviert die automatische Verlinkung von Glossarbegriffen im Text. |
| links | { externalIcon?: boolean; } | false | — | Darstellung von Links in Markdown-Inhalten und Theme-Komponenten. |
| links.externalIcon | boolean | false | true | Zeigt ein Symbol hinter externen Textlinks. Standardmäßig deaktiviert; reine Bild- und Icon-Links bleiben unverändert. |
| feedback | FeedbackProps | false | — | Konfiguration des Feedback-Formulars. Alle Felder sind in FeedbackProps beschrieben. |
| feedback.feedbackServerUrl | string | true | — | URL des Feedback-Servers, an den die Rückmeldungen gesendet werden. |
| feedback.gitlabProjectId | string | true | — | GitLab-Projekt-ID, unter der die Feedback-Issues erstellt werden. |
| feedback.headline | string | false | — | Überschrift des Feedback-Formulars. |
| feedback.description | string | false | — | Beschreibungstext des Feedback-Formulars (nur der Text innerhalb des Absatzes). |
| feedback.buttonText | string | false | — | Beschriftung der Absende-Schaltfläche. |
| feedback.labels | string[] | [ ] | true | — | GitLab-Labels, die den erstellten Feedback-Issues zugewiesen werden. |
| feedback.requiredText | string | true | — | Hinweistext, der die Kennzeichnung von Pflichtfeldern erläutert. |
| feedback.fields | FeedbackFields | true | — | Konfiguration der einzelnen Formularfelder (siehe FeedbackFieldConfig). |
| feedback.fields.email | FeedbackFieldConfig | false | — | Konfiguration des E-Mail-Feldes (optional). |
| feedback.fields.message | FeedbackFieldConfig | true | — | Konfiguration des Nachrichten-Feldes (Pflichtfeld). |
| feedback.shouldCreateConfidentialIssue | boolean | false | — | Erstellt das GitLab-Issue als vertraulich (confidential), wenn true. Nur im Developer Mode verfügbar. |
| feedback.notice | { title: string; body: string; link: { href: string; label: string; }; } | false | — | Optionaler Hinweiskasten, der im Feedback-Formular angezeigt wird. |
| feedback.notice.title | string | true | — | Titel des Hinweiskastens. |
| feedback.notice.body | string | true | — | Textkörper des Hinweiskastens. |
| feedback.notice.link | { href: string; label: string; } | true | — | Weiterführender Link im Hinweiskasten. |
| feedback.notice.link.href | string | true | — | Ziel-URL des Links. |
| feedback.notice.link.label | string | true | — | Beschriftung des Links. |
| feedback.privacyConsent | { textBeforeLink: string; link: { label: string; href: string; }; textAfterLink: string; } | true | — | Datenschutz-Einwilligung mit Checkbox und Link, die vor dem Absenden bestätigt werden muss. |
| feedback.privacyConsent.textBeforeLink | string | true | — | Text vor dem Datenschutz-Link. |
| feedback.privacyConsent.link | { label: string; href: string; } | true | — | Datenschutz-Link (z. B. zur Datenschutzerklärung). |
| feedback.privacyConsent.link.label | string | true | — | Beschriftung des Datenschutz-Links. |
| feedback.privacyConsent.link.href | string | true | — | Ziel-URL des Datenschutz-Links. |
| feedback.privacyConsent.textAfterLink | string | true | — | Text nach dem Datenschutz-Link. |
| feedback.afterSubmit | { successText: string; errorText: string; buttonLabel?: string; } | true | — | Texte, die nach dem Absenden des Formulars angezeigt werden. |
| feedback.afterSubmit.successText | string | true | — | Meldung bei erfolgreichem Absenden. |
| feedback.afterSubmit.errorText | string | true | — | Meldung bei fehlgeschlagenem Absenden. |
| feedback.afterSubmit.buttonLabel | string | false | — | Beschriftung der Schaltfläche im Bestätigungsdialog. |
| feedback.className | string | false | — | CSS-Klasse für den äußeren Container des Feedback-Formulars. |
| feedback.headlineClassName | string | false | — | CSS-Klasse für die Überschrift. |
| feedback.descriptionClassName | string | false | — | CSS-Klasse für den Beschreibungstext. |
| feedback.inputClassName | string | false | — | CSS-Klasse für die Eingabefelder. |
| feedback.inputLabelClassName | string | false | — | CSS-Klasse für die Feldbeschriftungen. |
| feedback.textareaClassName | string | false | — | CSS-Klasse für mehrzeilige Textfelder. |
| feedback.checkboxClassName | string | false | — | CSS-Klasse für die Checkbox. |
| feedback.btnClassName | string | false | — | CSS-Klasse für die Absende-Schaltfläche. |
| layoutComponent | (props: PropsWithChildren) => ReactNode | false | — | Benutzerdefinierte Layout-Komponente, die alle Seiten umschließt. |
| docsRepositoryBase | string | false | — | Veraltet: Basis-URL des Quell-Repositories. Verwenden Sie stattdessen project.link. |
| project | { link?: string; icon?: ReactNode | FC; } | false | — | Projekt-Link und optionales Icon für die obere Navigation. |
| project.link | string | false | — | URL zum Quell-Repository (z. B. GitLab-Projektseite). |
| project.icon | ReactNode | FC | false | — | Icon-Komponente, die neben dem Projekt-Link angezeigt wird. |
| umbrellaFooter | boolean | false | false | Aktiviert den Dachmarken-Footer (openCode / ZenDiS). |
| umbrellaHeader | boolean | false | false | Aktiviert den Dachmarken-Header (openCode / ZenDiS). |
| i18n | { uiElementTranslation?: { [locale: string]: Partial<typeof messages.en>; }; } | false | — | Übersetzungen für UI-Elemente der Theme-Oberfläche. |
| i18n.uiElementTranslation | { [locale: string]: Partial<typeof messages.en>; } | false | — | Sprachspezifische Übersetzungen der UI-Bezeichnungen, gegliedert nach Locale-Schlüssel. |
| banner | FC | false | — | Optionale Banner-Komponente, die oberhalb der gesamten Navigation angezeigt wird. |
| header | { component?: ReactNode | FC; centerElement?: ReactNode | FC; lowerBadgeLogoPath?: string; } | false | — | Konfiguration der Kopfzeile. |
| header.component | ReactNode | FC | false | — | Eigene Kopfzeilen-Komponente, die die Standard-Kopfzeile ersetzt. |
| header.centerElement | ReactNode | FC | false | — | Element, das in der Mitte der Kopfzeile angezeigt wird (z. B. Suchfeld oder Logo). |
| header.lowerBadgeLogoPath | string | false | — | Pfad zum Logo im unteren Badge-Bereich der Kopfzeile. |
| disableSearch | boolean | true | false | Deaktiviert die globale Suchfunktion. |
| hidePrimaryMenu | boolean | true | false | Blendet das primäre Navigationsmenü in der Kopfzeile aus. |
| primaryMenu | { title: string; iconEnabled?: boolean; } | false | — | Konfiguration des primären Navigationsmenüs. |
| primaryMenu.title | string | true | — | Bezeichnung des primären Menüs. |
| primaryMenu.iconEnabled | boolean | false | — | Zeigt Icons neben den Menüeinträgen an. |
| faviconGlyph | string | false | — | Zeichen oder Emoji, das als Favicon verwendet wird. |
| accessibilityLanguages | { leichteSpracheHref?: string; gebaerdenSprachenHref?: string; } | false | — | Links zur Leichten Sprache und zur Gebärdensprachen-Version der Website. |
| accessibilityLanguages.leichteSpracheHref | string | false | — | URL zur Leichte-Sprache-Version. |
| accessibilityLanguages.gebaerdenSprachenHref | string | false | — | URL zur Gebärdensprachen-Version. |
| footer | { component?: ReactNode | FC<{ menu: boolean; }>; links?: Array<{ name: string; href: string; column: string; }>; headingLevel?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6"; logo?: ReactNode | FC; description?: ReactNode | FC; copyright?: ReactNode | FC; } | true | — | Konfiguration des Footers. |
| footer.component | ReactNode | FC<{ menu: boolean; }> | false | [ref:Footer] | Eigene Footer-Komponente, die den Standard-Footer ersetzt. |
| footer.links | Array<{ name: string; href: string; column: string; }> | false | [array] | Footer-Links mit Name, URL und Spaltenzuordnung. |
| footer.headingLevel | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | false | — | HTML-Überschriftenebene für Spaltenüberschriften im Footer (z. B. "h2"). |
| footer.logo | ReactNode | FC | false | — | Logo-Komponente im Footer. |
| footer.description | ReactNode | FC | false | null | Beschreibungstext im Footer (z. B. Kurzbeschreibung der Organisation). |
| footer.copyright | ReactNode | FC | false | [complex] | Copyright-Hinweis im Footer. |
| toc | { disable?: boolean; title?: string; headingLevel?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6"; iconEnabled?: boolean; footer?: ReactNode; } | false | — | Konfiguration des seiteninternen Inhaltsverzeichnisses (TOC). |
| toc.disable | boolean | false | — | Deaktiviert das Inhaltsverzeichnis global für alle Seiten. |
| toc.title | string | false | — | Überschrift des Inhaltsverzeichnisses. |
| toc.headingLevel | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | false | — | HTML-Überschriftenebene für den TOC-Titel (z. B. "h2"). |
| toc.iconEnabled | boolean | false | — | Zeigt Icons neben den Einträgen im Inhaltsverzeichnis an. |
| toc.footer | ReactNode | false | — | Inhalt, der unterhalb der TOC-Einträge angezeigt wird (z. B. ein Link oder Hinweis). |
| head | ReactNode | false | — | Zusätzliche Elemente, die in den HTML-<head> der Seite eingefügt werden (z. B. Meta-Tags). |
| logo | ReactNode | FC | false | [jsx] | Logo-Komponente, die in der Kopfzeile angezeigt wird. |
| logoDark | ReactNode | FC | false | — | Logo für den Dunkelmodus. Ohne Angabe wird logo in beiden Modi genutzt. |
| logoText | string | false | "" | Text, der neben dem Logo angezeigt wird. |
| logoLink | boolean | string | true | true | URL des Logo-Links. Mit false wird der Link deaktiviert. |
| notFound | { content?: ReactNode | FC; labels?: string; } | false | — | Konfiguration der 404-Fehlerseite. |
| notFound.content | ReactNode | FC | false | — | Eigener Inhalt der 404-Seite. Hat Vorrang vor der eingebauten, übersetzten Beschreibung; ohne Angabe wird die lokalisierte Standardbeschreibung angezeigt. |
| notFound.labels | string | false | — | GitLab-Labels, die beim automatischen Erstellen von Issues für fehlerhafte Links vergeben werden. |
| search | { component?: ReactNode | FC<{ className?: string; }>; emptyResult?: ReactNode | FC; error?: string | (() => string); loading?: ReactNode | FC; placeholder?: string | (() => string); renderResult?: FC<SearchResultRendererProps>; } | true | — | Konfiguration der Suchfunktion. |
| search.component | ReactNode | FC<{ className?: string; }> | false | [ref:Flexsearch] | Eigene Such-Komponente, die die Standard-Suche ersetzt. |
| search.emptyResult | ReactNode | FC | false | [complex] | Anzeige, wenn keine Suchergebnisse gefunden wurden. |
| search.error | string | (() => string) | false | — | Fehlermeldung bei einem Suchfehler. |
| search.loading | ReactNode | FC | false | — | Ladeanzeige während der Suche. |
| search.placeholder | string | (() => string) | false | — | Platzhaltertext im Suchfeld. |
| search.renderResult | FC<SearchResultRendererProps> | false | — | Eigener Renderer für einzelne Suchergebnis-Einträge. Erhält Titel, Inhalt, Route und den aktuellen Suchbegriff. |
| sidebar | { disable: boolean; autoCollapse?: boolean; defaultMenuCollapseLevel: number; toggleButton: boolean; } | true | — | Konfiguration der Seitenleiste. |
| sidebar.disable | boolean | true | true | Deaktiviert die Seitenleiste global. |
| sidebar.autoCollapse | boolean | false | — | Klappt beim Öffnen eines Bereichs alle anderen automatisch zu. |
| sidebar.defaultMenuCollapseLevel | number | true | 2 | Einrückungstiefe, ab der Untermenüs standardmäßig eingeklappt werden. |
| sidebar.toggleButton | boolean | true | true | Zeigt die Schaltfläche zum Ein- und Ausblenden der Seitenleiste an. |
| editPage | { enabled: boolean; description?: string; repoBaseUrl: string; icon?: "auto" | "edit" | "github" | "opencode" | "gitlab" | "none"; } | true | — | Konfiguration des „Seite bearbeiten"-Links. |
| editPage.enabled | boolean | true | false | Aktiviert den „Seite bearbeiten"-Link auf jeder Seite. |
| editPage.description | string | false | Diese Seite bearbeiten | Beschriftung des „Seite bearbeiten"-Links. |
| editPage.repoBaseUrl | string | true | "" | Basis-URL zum Quell-Repository (z. B. https://gitlab.example.com/org/repo/-/blob/main/dokument). |
| editPage.icon | "auto" | "edit" | "github" | "opencode" | "gitlab" | "none" | false | auto | Icon-Stil für den „Seite bearbeiten"-Link. auto wählt anhand der repoBaseUrl automatisch. |
| theme | ThemeProviderProps | false | — | Konfiguration des Farbschemas (hell/dunkel/System) über next-themes. |
FeedbackFieldConfig
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| label | string | true | Beschriftung, die über dem Feld angezeigt wird. |
| placeholder | string | true | Platzhaltertext innerhalb des Eingabefelds. |
| required | boolean | false | Wenn true, muss das Feld ausgefüllt werden, bevor das Formular abgesendet werden kann. |
| type | HTMLInputTypeAttribute | "textarea" | "select" | "multiselect" | false | Eingabetyp des Feldes. Zusätzlich zu den Standard-HTML-Eingabetypen werden "textarea", "select" (Einfachauswahl) und "multiselect" (Mehrfachauswahl) unterstützt. Ohne Angabe wird ein einfaches Textfeld verwendet. |
| description | ReactNode | false | Optionaler Hilfetext, der neben dem Feld angezeigt wird. |
| options | string[] | false | Auswählbare Werte. Nur relevant, wenn type auf "select" oder "multiselect" gesetzt ist. |
| allowCustom | boolean | false | Nur wirksam, wenn type auf "multiselect" gesetzt ist. Fügt der Auswahlliste einen Eintrag „Sonstige“ hinzu; bei dessen Auswahl erscheint ein Freitextfeld, über das Nutzende einen eigenen, nicht in options enthaltenen Wert angeben können. Bei allen anderen Feldtypen wird die Option ignoriert. |