Skip to content

共享點陣圖 ​

在所有地區設定共用單一圖片(沒有按地區設定的變體)時使用。

  • 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 變體:翻譯儀表板指南 將其螢幕截圖引用為 ![Translation Dashboard](/translation-dashboard.png) — 這是一個從 docs/public/translation-dashboard.png 提供的絕對網站根目錄路徑。因為每個地區設定的 URL 都相同,所以不需要 postProcessing.regexAdjustments 規則。

採用 MIT 授權條款釋出。