Raster compartilhado
Use quando uma única imagem é compartilhada entre todas as localidades (sem variante por localidade).
docsOutput.style = "flat"— o reescritor de links flat calcula o prefixo de profundidade por arquivo de saída, para que um recurso relativo ao lado do arquivo de origem (por exemplo,docs/figure.pngreferenciado comofigure.pngdedocs/page.md) seja resolvido corretamente em cada saída traduzida — nenhuma regra depostProcessing.regexAdjustmentsé necessária. Quando os arquivos de origem estão em subdiretórios, habiliteflatPreserveRelativeDir: truepara que os caminhos de saída preservem a árvore de origem (consulte Prefixo de profundidade por arquivo).docsOutput.style = "vitepress"(e outras predefinições de sistema de documentação com um normalizador de links) — caminhos absolutos da raiz do site, como/translation-dashboard.png, são mantidos inalterados quando a URL é idêntica em todos os locais — nenhuma regra deregexAdjustmentsé necessária.
Exemplo "flat": um projeto traduz docs/guide/quick-start.md para translated-docs/docs/guide/quick-start.<locale>.md. Isso assume flatPreserveRelativeDir: true para que docs/guide/quick-start.md seja enviado para translated-docs/docs/guide/quick-start.<locale>.md (não translated-docs/quick-start.<locale>.md). Uma imagem irmã docs/translation-dashboard.png é referenciada de quick-start.md como ../translation-dashboard.png. O reescritor calcula o prefixo por arquivo do diretório do arquivo de saída de volta para o diretório de origem (../../docs/), produzindo ../../docs/translation-dashboard.png. De translated-docs/docs/guide/, isso é resolvido corretamente de volta para docs/translation-dashboard.png.
Uma regra de postProcessing ainda é necessária quando:
- O recurso é referenciado por meio de uma URL absoluta em
docsOutput.style = "flat"(por exemplo,/img/figure.png) — o reescritor flat só lida com caminhos relativos - Você deseja alterar a URL do recurso por outros motivos (por exemplo, mudar para uma CDN)
Exemplo de implementação
A própria documentação deste repositório usa a variante de URL absoluto de imagens compartilhadas: o guia do Painel de Tradução referencia sua captura de tela como  — um caminho absoluto da raiz do site servido de docs/public/translation-dashboard.png. Como o URL é idêntico para cada localidade, nenhuma regra postProcessing.regexAdjustments é necessária.