共享栅格

当所有语言区域共享同一张图片（没有按语言区域的变体）时使用。

• docsOutput.style = "flat" — 扁平链接重写器会按每个输出文件计算深度前缀，因此源文件旁边的相对资源（例如从 docs/page.md 中引用的 docs/figure.png 为 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 规则。