Link-Prüfung
So richtest du eine automatische Prüfung auf tote Links mit Lychee in deiner CI/CD-Pipeline ein.
Was wird geprüft?
Die CI-Komponente link-checker verwendet Lychee, um alle Links in deiner gebauten Webseite zu prüfen:
- Interne Links (Seiten, Anker, Assets)
- Externe Links (HTTP-Status-Codes)
- Bild-Referenzen
CI-Komponente einbinden
Ergänze deine .gitlab-ci.yml um die Link-Checker-Komponente:
Hinweis
Die Link-Prüfung läuft nach dem Build-Schritt und prüft die generierten HTML-Dateien auf tote Links.
Ergebnisse lesen
Die Prüfung gibt im Pipeline-Log eine Liste aller gefundenen Probleme aus:
- 404: Die Zielseite existiert nicht
- Timeout: Der externe Server antwortet nicht
- Anchor not found: Der Anker (
#abschnitt) existiert nicht auf der Zielseite
Häufige Probleme beheben
| Problem | Lösung |
|---|---|
| Interner Link 404 | Dateiname oder Pfad prüfen — Dateiname (ohne Endung) = URL-Pfad |
| Externer Link 404 | URL aktualisieren oder Link entfernen |
| Anker nicht gefunden | Überschrift prüfen — Anker werden aus Überschriftentext generiert |
| Bild nicht gefunden | Pfad zum assets-Ordner prüfen |