Estructura de Salida

Cada build produce un árbol de directorios plano de archivos. Esta página mapea qué vive dónde, para que sepas exactamente qué pasa a live.

Raíces por idioma

En el modo de URL por ruta por defecto, cada Idioma Activo tiene su propio subárbol:

output/
  en/
  es/
  pt/

Sin segmentos de idioma (modo de un solo idioma), el contenido queda directamente en output/. Con el modo de subdominio, los mismos directorios por idioma llevan el contenido, y tu servidor web enruta cada subdominio de idioma a su directorio.

La promoción reemplaza el árbol live mediante un symlink o un rename de directorio; los visitantes solo ven siempre un árbol completamente compilado.

Archivos de páginas y posts

• Las páginas viven en su propia ruta anidada: output/en/about/philosophy/index.html para una página hija bajo su padre.
• Los posts viven bajo el prefijo del blog dentro del árbol de idioma: output/en/blog/my-post/index.html (el prefijo por defecto es blog y puede cambiarse por idioma).
• Los archivos de categorías también quedan dentro del prefijo del blog: /blog/category/<slug>/.

Las categorías y las páginas se anidan desde la estructura de contenido del admin; las reglas básicas de URL provienen de los ajustes de URL de cada idioma.

Archivos compartidos por idioma

Cada directorio de idioma también lleva sus archivos de detección e index generados:

• sitemap.xml
• robots.txt
• feed.xml: solo cuando ese idioma tiene al menos un post publicado
• search-index.json: el índice que alimenta la búsqueda del sitio
• 404.html: la página de no encontrado compilada
• .well-known/security.txt: cuando hay un contacto de seguridad configurado
• Extras de PWA cuando están habilitados: manifest.json, sw.js, offline.html

A nivel raíz: una página de redirección (o una página real) ocupa output/{lang}/index.html según hacia dónde deba apuntar la raíz del dominio.

Los assets se sincronizan por idioma

Los directorios compartidos grandes se copian por idioma en cada build:

• media/: las cargas de la pantalla de medios del admin, espejadas en cada árbol de idioma; solo se reescriben los archivos modificados, así que los assets sincronizados atraviesan los builds sin cambios.
• fonts/: los archivos de tipografía del sitio.
• Archivos de favicon en la raíz del idioma (favicon.ico, favicon-96x96.png, apple-touch-icon.png) cuando hay alguno configurado.

Un archivo de logo debe existir bajo la carpeta de assets del sitio; los builds advierten "not found in assets/, skipping" si el ajuste nombra uno que no está ahí. El build log marca cada sincronización con una línea "media synced" por directorio de idioma.

Redirecciones

Las redirecciones se renderizan de dos maneras en el árbol:

• páginas HTML de redirección en las rutas antiguas (con enlaces canónicos), por idioma;
• snippets de configuración de servidor generados en la raíz de salida (_redirects.caddy), y para configuraciones al estilo netlify también un archivo _redirects; las redirecciones por patrón existen solo como páginas HTML.

Fuera del árbol de salida

El build también escribe un manifest firmado fuera de la salida: un directorio private/ junto a ella contiene build-manifest.json y su firma. Esta es la declaración de integridad de lo que pasó a live, y ante una promoción fallida se restaura el manifest anterior, sin sobrescribirse.