documents.tt

documents.tt rend la page de listing des documents publique : la grille navigable de fichiers téléchargeables du site, générée à /documents/ dans chaque langue. C'est un template entièrement thémé : partials header et footer inclus, head standard, et grille de cartes conçue pour être triable.

Ce qu'il rend

Une carte par document, liant vers son téléchargement (/documents/) :

• Icône de type: choisie d'après le type MIME du fichier (PDf, image, sinon un trombone générique).
• Titre + description: le texte du lien de la carte et un chapeau optionnel.
• Badges méta : taille du fichier (Ko ou Mo, calculée), code de langue (en majuscules), nom du dossier.
• Un état vide (« No documents available. ») quand le listing de la langue se révèle vide.

Ce qui est inclus

Seul un contenu sûr figure dans le listing, par langue au moment du build :

• Publiés uniquement: les documents non publiés n'apparaissent jamais.
• Fenêtres de publication respectées: les documents pas encore dans une fenêtre de publication programmée, ou au-delà de leur fenêtre de dépublication, sont exclus.
• Cette langue seulement: les documents de en n'apparaissent pas dans le listing es.
• Triés par titre, canonisés vers l'URL /documents/ de la langue.

Considérations de thème

• Le template réside dans builder/site_templates/ (ou le répertoire de votre thème, recherché en premier : la règle de recherche standard de la page template-files).
• Vous pouvez le remplacer entièrement par thème : les noms de classes de la grille (documents-grid, documents-card, spans icône/titre/desc/meta) plus page_title et documents dans le stash constituent la surface complète du template ; les partials header/footer standard et les attributs cache-modal s'appliquent comme d'habitude.
• Les cartes lient vers des pages de document préfixées par l'URL (p. ex. /documents/), et le téléchargement lui-même est servi par le CMS, d'où la route proxy /documents/ de la page d'hébergement (la page générée est purement présentationnelle ; le téléchargement dynamique passe par le proxy).

Prérequis de build

• Le listing n'apparaît que lorsque la fonctionnalité documents est utilisée ; une langue sans documents publiés rend l'état vide, et la ligne docs : /<lang>/documents/ du log de build trace sa présence.