Edit-Page-Link einrichten
So aktivierst du den „Seite bearbeiten"-Link, der Besucher:innen direkt zur Quelldatei im Repository führt.
Hinweis
Edit-Page-Link wird im Easy Mode (CI-Komponente) nicht unterstützt — nur im Developer Mode konfigurierbar.
Developer Mode
Konfiguriere den editPage-Block in der theme.config.tsx:
Parameter
| Eigenschaft | Typ | Erforderlich | Default | Beschreibung |
|---|---|---|---|---|
enabled | boolean | ✓ | false | Link aktivieren |
repoBaseUrl | string | ✓ | "" | Basis-URL, an die der Dateipfad angehängt wird |
description | string | — | "Diese Seite bearbeiten" | Angezeigter Linktext |
icon | "auto" | "edit" | "github" | "opencode" | "gitlab" | "none" | — | "auto" | Icon neben dem Link |
URL-Aufbau
Der Link wird durch einfache Konkatenation gebildet:
{repoBaseUrl}/{Dateipfad}
Der Dateipfad enthält den Pfad inklusive pages/-Präfix (z. B. pages/how-to-guides/edit-page-link.mdx). Damit der Link direkt zum Editor führt, muss repoBaseUrl den passenden Edit-Pfad enthalten:
| Plattform | repoBaseUrl |
|---|---|
| GitLab | https://gitlab.example.com/org/repo/-/edit/main |
| GitHub | https://github.com/org/repo/edit/main |
Verfügbare Icons
| Wert | Beschreibung |
|---|---|
auto | Erkennt die Plattform anhand der Teilstrings gitlab, github, opencode in der URL — fällt auf edit zurück, wenn keiner passt |
edit | Generisches Bearbeiten-Icon (Stift) |
github | GitHub-Icon |
gitlab | GitLab-Icon |
opencode | openCode-Icon |
none | Kein Icon |
Ergebnis
Im Inhaltsverzeichnis (TOC) jeder Seite erscheint ein Link, der zur entsprechenden Quelldatei im Repository führt.