Geteiltes Raster
Verwenden Sie diese Option, wenn ein einzelnes Bild für alle Gebietsschemata freigegeben wird (keine Variante pro Gebietsschema).
docsOutput.style = "flat"— der flache Link-Rewriter berechnet das Tiefenpräfix pro Ausgabedatei, sodass ein relatives Asset neben der Quelldatei (z. B.docs/figure.png, referenziert alsfigure.pngvondocs/page.md) in jeder übersetzten Ausgabe korrekt aufgelöst wird — keinepostProcessing.regexAdjustments-Regel ist erforderlich. Wenn Quelldateien in Unterverzeichnissen liegen, aktivieren SieflatPreserveRelativeDir: true, damit Ausgabepfade die Quellbaumstruktur beibehalten (siehe Tiefenpräfix pro Datei).docsOutput.style = "vitepress"(und andere Doc-System-Voreinstellungen mit einem Link-Normalisierer) — absolute Pfade zum Website-Stammverzeichnis, wie z. B./translation-dashboard.png, bleiben unverändert, wenn die URL in jedem Gebietsschema identisch ist — keineregexAdjustments-Regel ist erforderlich.
Flaches Beispiel: Ein Projekt übersetzt docs/guide/quick-start.md nach translated-docs/docs/guide/quick-start.<locale>.md. Dies setzt flatPreserveRelativeDir: true voraus, sodass docs/guide/quick-start.md nach translated-docs/docs/guide/quick-start.<locale>.md (nicht translated-docs/quick-start.<locale>.md) ausgegeben wird. Ein gleichrangiges Bild docs/translation-dashboard.png wird von quick-start.md als ../translation-dashboard.png referenziert. Der Rewriter berechnet das Präfix pro Datei vom Verzeichnis der Ausgabedatei zurück zum Quellverzeichnis (../../docs/), wodurch ../../docs/translation-dashboard.png entsteht. Von translated-docs/docs/guide/ aus wird dies korrekt zurück zu docs/translation-dashboard.png aufgelöst.
Eine postProcessing-Regel ist weiterhin erforderlich, wenn:
- Das Asset über eine absolute URL in
docsOutput.style = "flat"referenziert wird (z. B./img/figure.png) — der flache Rewriter verarbeitet nur relative Pfade - Sie die Asset-URL aus anderen Gründen ändern möchten (z. B. Wechsel zu einem CDN)
Implementierungsbeispiel
Die Dokumentation dieses Repositorys verwendet die absolute URL-Variante von freigegebenen Bildern: Der Leitfaden zum Übersetzungs-Dashboard referenziert seinen Screenshot als  – einen absoluten, site-root-Pfad, der von docs/public/translation-dashboard.png bereitgestellt wird. Da die URL für jedes Gebietsschema identisch ist, ist keine postProcessing.regexAdjustments-Regel erforderlich.