Skip to content

Ráster compartido ​

Se utiliza cuando se comparte una sola imagen en todas las configuraciones regionales (sin variantes por configuración regional).

  • docsOutput.style = "flat" — el reescritor de enlaces planos calcula el prefijo de profundidad por archivo de salida, para que un recurso relativo junto al archivo de origen (p. ej., docs/figure.png referenciado como figure.png desde docs/page.md) se resuelva correctamente en cada salida traducida — no se necesita ninguna regla postProcessing.regexAdjustments. Cuando los archivos de origen residen en subdirectorios, habilite flatPreserveRelativeDir: true para que las rutas de salida conserven el árbol de origen (consulte Prefijo de profundidad por archivo).
  • docsOutput.style = "vitepress" (y otros ajustes preestablecidos del sistema de documentación con un normalizador de enlaces) — las rutas absolutas de la raíz del sitio, como /translation-dashboard.png, se dejan sin cambios cuando la URL es idéntica en todas las configuraciones regionales — no se necesita ninguna regla regexAdjustments.

Ejemplo plano: un proyecto traduce docs/guide/quick-start.md a translated-docs/docs/guide/quick-start.<locale>.md. Esto asume flatPreserveRelativeDir: true para que docs/guide/quick-start.md se genere en translated-docs/docs/guide/quick-start.<locale>.md (no en translated-docs/quick-start.<locale>.md). Una imagen hermana docs/translation-dashboard.png se referencia desde quick-start.md como ../translation-dashboard.png. El reescritor calcula el prefijo por archivo desde el directorio del archivo de salida hasta el directorio de origen (../../docs/), produciendo ../../docs/translation-dashboard.png. Desde translated-docs/docs/guide/, eso se resuelve correctamente de nuevo en docs/translation-dashboard.png.

Todavía se necesita una regla postProcessing cuando:

  • El recurso se referencia mediante una URL absoluta en docsOutput.style = "flat" (p. ej., /img/figure.png) — el reescritor plano solo gestiona rutas relativas
  • Desea cambiar la URL del recurso por otras razones (p. ej., cambiar a una CDN)

Ejemplo de implementación ​

La documentación de este repositorio utiliza la variante de URL absoluta de las imágenes compartidas: la guía del Panel de traducción hace referencia a su captura de pantalla como ![Translation Dashboard](/translation-dashboard.png), una ruta absoluta de la raíz del sitio servida desde docs/public/translation-dashboard.png. Dado que la URL es idéntica para cada configuración regional, no se necesita ninguna regla postProcessing.regexAdjustments.

Publicado bajo la licencia MIT.