documents.tt

documents.tt renderiza a página de listagem de documentos pública : a grade navegável do site de arquivos baixáveis, construída em /documents/ em cada idioma. É um template totalmente tematizado: partials de header e rodapé incluídos, head padrão, e uma grade de cards ordenada por design.

O que renderiza

Um card por documento, apontando ao seu download (/documents/<slug>):

• Ícone de tipo : escolhido pelo tipo MIME do arquivo (PDF, imagem, senão um clipe de papel genérico).
• Título + descrição : o texto de link do card e o lead-in opcional.
• Badges de meta: tamanho do arquivo (KB ou MB, computado), código de idioma (em maiúsculas), nome da pasta.
• Um estado vazio (“No documents available.”) quando a listagem do idioma vem vazia.

O que é incluído

Apenas conteúdo seguro embarca na listagem, por idioma em tempo de build:

• Apenas publicados : documentos não publicados nunca aparecem.
• Janelas de agendamento respeitadas : documentos que ainda não entraram numa janela de publicação agendada, ou que passaram de sua janela de despublicação, são excluídos.
• Aquele idioma apenas : documentos de en não aparecem na listagem de es.
• Ordenado por título, canonicalizado à URL /documents/ do idioma.

Considerações de tema

• O template vive em builder/site_templates/ (ou no diretório do seu tema, que é buscado primeiro : a regra padrão de busca da página de template-files).
• Você pode substituí-lo em peso por tema: os nomes de classe da grade (documents-grid, documents-card, spans de ícone/título/desc/meta) mais page_title e documents no stash são a superfície completa do template; os partials padrão de header/rodapé e os atributos cache-modal se aplicam como usual.
• Os cards apontam para páginas de documento com prefixo de URL (por exemplo <url_base>/documents/<slug>), e o download em si é servido pelo CMS : daí a rota de proxy /documents/ na página de hospedagem (a página construída é apresentacional; o download dinâmico acontece através do proxy).

Requisitos de build

• A listagem só aparece quando a funcionalidade de documentos está em uso; um idioma sem documentos publicados renderiza o estado vazio, e a linha docs : /<lang>/documents/ do build log rastreia sua presença.