Defekte Links beheben

jamdesk fix ergänzt jamdesk broken-links um eine automatische Reparatur. Der Befehl liest dieselben Warnungen zu defekten Links und schreibt jede Datei neu, für die sich das korrekte Ziel eindeutig bestimmen lässt. Mehrdeutige Fälle werden zur manuellen Prüfung markiert und nicht geändert.

Der Befehl behebt zwei Arten defekter interner Links:

• Fehlerhafte Anker — ein Fragment, das eine eindeutige Falschschreibung einer echten Überschrift auf der Zielseite ist (z. B. #instalation → #installation)
• Ankerabweichungen zwischen Locales — eine übersetzte Seite hat ihre Überschriften umbenannt, aber Links in diesem Locale verweisen weiterhin auf das alte englische Fragment (z. B. /fr/ai/selectors#ai-strategies → /fr/ai/selectors#stratégies-ia)

Schritt 1: Defekte Links finden

Führen Sie jamdesk broken-links aus, um zu sehen, was behoben werden muss:

jamdesk broken-links

Prüfen Sie die Ausgabe. jamdesk fix bearbeitet Warnungen, bei denen ein wahrscheinlich korrekter Anker einer echten Überschrift zugeordnet werden kann.

Schritt 2: Korrekturen in der Vorschau anzeigen

Führen Sie den Befehl mit --dry-run aus, um genau zu sehen, was sich ändern würde, bevor Dateien angefasst werden:

jamdesk fix --dry-run

Beispielausgabe:

Planned fixes:

  fr/ai/overview.mdx:9
    /fr/ai/selectors#ai-strategies  →  /fr/ai/selectors#stratégies-ia

(dry run — no files written)

Prüfen Sie jede geplante Korrektur. Wenn eine Änderung nicht korrekt aussieht, korrigieren Sie den Link stattdessen manuell. jamdesk fix schreibt nur Links neu, die sich eindeutig auflösen lassen.

Schritt 3: Korrekturen anwenden

Führen Sie den Befehl ohne --dry-run aus, um die Korrekturen anzuwenden. Sie werden zur Bestätigung aufgefordert:

jamdesk fix

Apply 1 fix(es) to local files? (y/N)

Drücken Sie y, um die Änderungen zu schreiben. Um die Abfrage in CI oder Skripten zu überspringen, verwenden Sie -y:

jamdesk fix -y

Nach der Anwendung gibt der Befehl Folgendes aus:

Fixed 1 file(s); 0 warning(s) left for manual review.

Wenn das Ziel einer Warnung mehrdeutig ist, lässt jamdesk fix den Link unverändert, damit Sie ihn manuell korrigieren können.

Schritt 4: Diff prüfen und committen

Prüfen Sie die Änderungen vor dem Committen:

git diff

Vergewissern Sie sich, dass jeder neu geschriebene Link auf das erwartete Ziel verweist. Committen Sie anschließend:

git add -A
git commit -m "fix(docs): auto-fix broken internal links"

Optionen

Wie geht es weiter?