C’est ici qu’un thème se décrit et configure quelques comportements, sans toucher à un gabarit. Voici ce qu’utilisent les thèmes fournis :
title: "Ink" description: "Un thème sobre et minimaliste" version: "1.0.0" author: "FolioPress"
meta: supports_dark_mode: true responsive: true categories: [minimal, portfolio]
settings: # libre ; disponible dans les gabarits sous theme_settings primary_color: "#2563eb"
home: posts: 10 # combien d’articles la page d’accueil reçoit order_by: "-published_at" # les plus récents d’abord has_pagination: false # une coupure, ou de vrais liens de page ? image_ratios: poster: "16:9" # ce que propose l’outil de recadrage de l’administration ici gallery: "free"
page: { posts: 10, order_by: "-published_at", has_pagination: false } post: { posts: 3, order_by: "-published_at" } # articles liés sous un article tag: { posts: 12, order_by: "-published_at", has_pagination: true }
page-about: # surcharge pour une page, par son slug en langue principale image_ratios: { poster: "1:1" } post-tutorials: # surcharge pour les articles dont la première étiquette a ce slug image_ratios: { poster: "4:3" }
Clé Ce qu’elle contrôle
title, description, version, author Affichés sur la page Thèmes de l’administration.
meta.supports_dark_mode, meta.responsive, meta.categories Descriptifs ; utilisés pour la galerie de thèmes.
meta.social_image Un fichier dans le static/ du thème, en 1200x630, utilisé comme image d'aperçu quand une page n'a pas d'image à la une. Sans lui, cette page est partagée avec l'icône de 180x180.
settings Ce que vous voulez. Transmis à chaque gabarit sous theme_settings, pour qu’une couleur ou un slogan puisse vivre ici plutôt que dans le CSS.
home, page, post, tag La liste d’articles que reçoit ce type de gabarit : posts (combien), order_by, et si has_pagination ajoute de vrais liens de page ou coupe simplement la liste.
order_by -published_at (les plus récents d’abord) ou published_at ; de même created_at et updated_at, avec ou sans le - initial ; ou random.
image_ratios Ce que l’outil de recadrage de l’administration propose lors de l’édition de ce type de contenu : un ratio comme 16:9, une liste de ratios, ou free. Valeurs distinctes pour poster et gallery.
page-<slug>, post-<tag-slug> Les mêmes clés, surchargeant page/post pour une page (par son slug en langue principale) ou pour les articles dont la première étiquette porte ce slug.