共享點陣圖
在所有地區設定共用單一圖片(沒有按地區設定的變體)時使用。
docsOutput.style = "flat"— 平面連結重寫器會根據每個輸出檔案計算深度前綴,因此來源檔案旁的相對資產(例如,從docs/page.md參考為figure.png的docs/figure.png)在每個翻譯輸出中都能正確解析 — 不需要postProcessing.regexAdjustments規則。當來源檔案位於子目錄中時,請啟用flatPreserveRelativeDir: true以便輸出路徑保留來源樹狀結構(請參閱 每個檔案的深度前綴)。docsOutput.style = "vitepress"(以及其他帶有連結正規化器的文件系統預設集)— 當 URL 在每個地區設定中都相同時,網站根目錄的絕對路徑(例如/translation-dashboard.png)會保持不變 — 不需要regexAdjustments規則。
扁平範例: 專案將 docs/guide/quick-start.md 翻譯為 translated-docs/docs/guide/quick-start.<locale>.md。這假設 flatPreserveRelativeDir: true,因此 docs/guide/quick-start.md 輸出至 translated-docs/docs/guide/quick-start.<locale>.md(而非 translated-docs/quick-start.<locale>.md)。同層圖片 docs/translation-dashboard.png 從 quick-start.md 引用為 ../translation-dashboard.png。重寫器從輸出檔案的目錄計算回來源目錄的每個檔案前綴(../../docs/),產生 ../../docs/translation-dashboard.png。從 translated-docs/docs/guide/ 來看,這會正確解析回 docs/translation-dashboard.png。
在以下情況下,仍然需要 postProcessing 規則:
- 資產透過
docsOutput.style = "flat"中的絕對 URL 參考(例如/img/figure.png)— 平面重寫器僅處理相對路徑 - 您想因其他原因更改資產 URL(例如,切換到 CDN)
實作範例
此存放庫自身的文件使用共用圖片的絕對 URL 變體:翻譯儀表板指南 將其螢幕截圖引用為  — 這是一個從 docs/public/translation-dashboard.png 提供的絕對網站根目錄路徑。因為每個地區設定的 URL 都相同,所以不需要 postProcessing.regexAdjustments 規則。