documents.tt

documents.tt renderiza la página de listado de documentos pública: la cuadrícula navegable de archivos descargables del site, construida en /documents/ en cada idioma. Es una template completamente tematizada: con los parciales de header y footer incluidos, head estándar y una cuadrícula de tarjetas ordenable por diseño.

Qué renderiza

Una tarjeta por documento, con enlace a su descarga (/documents/):

• Icono de tipo: elegido según el tipo MIME del archivo (PDf, imagen, o un clip genérico en el resto de los casos).
• Título + descripción: el texto del enlace de la tarjeta y una introducción opcional.
• Insignias de metadatos: tamaño del archivo (KB o MB, calculado), código de idioma (en mayúsculas), nombre de la carpeta.
• Un estado vacío ("No documents available.") cuando el listado del idioma no tiene elementos.

Qué se incluye

Solo se publica contenido seguro en el listado, por idioma en tiempo de build:

• Solo publicados: los documentos no publicados nunca aparecen.
• Ventanas de programación respetadas: los documentos que aún no están dentro de una ventana de publicación programada, o que ya pasaron su ventana de despublicación, se excluyen.
• Solo ese idioma: los documentos de en no aparecen en el listado de es.
• Ordenados por título, canonicalizados a la URL /documents/ del idioma.

Consideraciones de theme

• La template vive en builder/site_templates/ (o en el directorio de tu theme, que se busca primero: la regla de búsqueda estándar de la página template-files).
• Puedes reemplazarla por completo por theme: los nombres de clase de la cuadrícula (documents-grid, documents-card, los spans de icono/título/desc/meta) más page_title y documents en el stash son toda la superficie de la template; los parciales estándar de header/footer y los atributos de cache-modal se aplican como siempre.
• Las tarjetas enlazan a páginas de documentos con prefijo de URL (por ejemplo /documents/), y la descarga en sí la sirve el CMS: de ahí la ruta de proxy /documents/ en la página de hosting (la página construida es presentacional; la descarga dinámica ocurre a través del proxy).

Requisitos de build

• El listado solo aparece cuando la función de documentos está en uso; un idioma sin documentos publicados renderiza el estado vacío, y la línea docs : /<lang>/documents/ del log de build registra su presencia.