# Seitendetails

Rund um den Inhalt jeder Seite ergänzt Clay, was Leser zur Orientierung brauchen: ein Inhaltsverzeichnis, wann die Seite zuletzt geändert wurde, einen Link, um sie zu verbessern, und den Weg zur nächsten Seite. Gedruckt ist eine Seite nur ihr Text.

## Inhaltsverzeichnis

Auf breiten Bildschirmen listet ein Inhaltsverzeichnis neben der Seite ihre `##`- und `###`-Überschriften. Beim Scrollen markiert eine Linie daneben jeden Abschnitt, der zu sehen ist; ein Klick springt dorthin. Auf schmaleren Bildschirmen klappt es stattdessen über der Seite auf. Seiten mit nur einer Überschrift kommen ohne aus.

## Zuletzt aktualisiert

Unten auf jeder Seite zeigt Clay, wann sie zuletzt geändert wurde, aus dem letzten Git-Commit, der die Datei verändert hat:

> Zuletzt aktualisiert: 14. Oktober 2026

Das Datum wird in der Sprache der Seite formatiert. Dafür muss die Dokumentation in einem Git-Repository mit seiner Historie liegen. Checke in der CI die ganze Historie aus; die meisten CI-Systeme klonen standardmäßig nur den letzten Commit:

::: tabs
== GitHub Actions
```yaml
- uses: actions/checkout@v7
  with:
    fetch-depth: 0
```
== GitLab CI
```yaml
variables:
  GIT_DEPTH: 0
```
:::

Ohne Git-Historie fehlen die Daten, und der Build weist darauf hin:

```console
▲ the docs are not in a git repository: last-updated dates are skipped
```

Diese Warnung lässt einen Build nie scheitern, auch nicht mit `--strict`.

## Diese Seite bearbeiten

Mit `editURL` in der `clay.yaml` verlinkt jede Seite ihre Quelldatei, damit Leser einen Tippfehler in einer Minute beheben können:

```yaml [clay.yaml]
editURL: "https://github.com/meine-org/mein-projekt/edit/main/docs/"
```

Auf übersetzten Seiten führt der Link zur Übersetzung, mit [Versionen](https://clay-doc.github.io/clay-example-repo/de/organizing/versions.md) in den Ordner der Version, `docs/latest/` oder `docs/<name>/`.

## Vor und zurück

Das letzte Element jeder Seite verlinkt auf die vorherige und die nächste Seite, in der Reihenfolge der Seitenleiste, über Ordnergrenzen hinweg. So lässt sich die Dokumentation von vorne bis hinten lesen, ohne die Seitenleiste zu öffnen.

## Drucken

Eine Seite drucken oder im Druckdialog des Browsers als PDF speichern ergibt nur ihren Text: ohne Navigationsleiste, Seitenleiste, Inhaltsverzeichnis und Fußzeilen, und im hellen Design, auch wenn die Seite dunkel ist. Was nur auf dem Bildschirm funktioniert, wird ausgeschrieben:

- jeder Tab wird gedruckt, jeder unter seiner Beschriftung,
- eingeklappte [Details](https://clay-doc.github.io/clay-example-repo/de/writing/components/details.md) sind offen,
- Links auf andere Websites zeigen ihre Adresse dahinter,
- lange Codezeilen brechen um, statt abgeschnitten zu werden.

Codeblöcke, Tabellen und Bilder werden nicht auf zwei Blätter verteilt, und Überschriften bleiben bei dem Text darunter.

---

All pages of these docs, as Markdown for language models: https://clay-doc.github.io/clay-example-repo/de/llms.txt
