É aqui que um tema se descreve e configura alguns comportamentos, sem tocar num template. Isto é o que os temas incluídos usam:
title: "Ink" description: "Um tema limpo e minimalista" version: "1.0.0" author: "FolioPress"
meta: supports_dark_mode: true responsive: true categories: [minimal, portfolio]
settings: # livre; disponível nos templates como theme_settings primary_color: "#2563eb"
home: posts: 10 # quantos artigos a página inicial recebe order_by: "-published_at" # mais recentes primeiro has_pagination: false # um corte, ou ligações de página reais? image_ratios: poster: "16:9" # o que o recorte de imagens da administração oferece aqui gallery: "free"
page: { posts: 10, order_by: "-published_at", has_pagination: false } post: { posts: 3, order_by: "-published_at" } # artigos relacionados sob um artigo tag: { posts: 12, order_by: "-published_at", has_pagination: true }
page-about: # substituição para uma página, pelo slug no idioma principal image_ratios: { poster: "1:1" } post-tutorials: # substituição para artigos cuja primeira etiqueta tem este slug image_ratios: { poster: "4:3" }
Chave O que controla
title, description, version, author Mostrados na página Temas da administração.
meta.supports_dark_mode, meta.responsive, meta.categories Descritivos; usados na galeria de temas.
meta.social_image Um ficheiro em static/ do tema, com 1200x630, usado como imagem de pré-visualização quando uma página não tem imagem de destaque própria. Sem ele, essa página é partilhada com o ícone de 180x180.
settings O que quiser. Entregue a todos os templates como theme_settings, para que uma cor ou um slogan possam viver aqui em vez de no CSS.
home, page, post, tag A lista de artigos que esse tipo de template recebe: posts (quantos), order_by, e se has_pagination acrescenta ligações de página reais ou apenas corta a lista.
order_by -published_at (mais recentes primeiro) ou published_at; o mesmo para created_at e updated_at, com ou sem o - inicial; ou random.
image_ratios O que o recorte de imagens da administração oferece ao editar esse tipo de conteúdo: uma proporção como 16:9, uma lista delas, ou free. Valores separados para poster e gallery.
page-<slug>, post-<tag-slug> As mesmas chaves, substituindo page/post para uma página (pelo slug no idioma principal) ou para os artigos cuja primeira etiqueta tem esse slug.