Hier beschrijft een thema zichzelf en stelt het een paar gedragingen in, zonder een sjabloon aan te raken. Dit is wat de meegeleverde thema’s gebruiken:
title: "Ink" description: "Een schoon, minimalistisch thema" version: "1.0.0" author: "FolioPress"
meta: supports_dark_mode: true responsive: true categories: [minimal, portfolio]
settings: # vrij in te vullen; in sjablonen beschikbaar als theme_settings primary_color: "#2563eb"
home: posts: 10 # hoeveel berichten de startpagina krijgt order_by: "-published_at" # nieuwste eerst has_pagination: false # afkappen, of echte paginalinks? image_ratios: poster: "16:9" # wat de bijsnijder in het beheer hier aanbiedt gallery: "free"
page: { posts: 10, order_by: "-published_at", has_pagination: false } post: { posts: 3, order_by: "-published_at" } # gerelateerde berichten onder een bericht tag: { posts: 12, order_by: "-published_at", has_pagination: true }
page-about: # overschrijving voor één pagina, via haar slug in de hoofdtaal image_ratios: { poster: "1:1" } post-tutorials: # overschrijving voor berichten waarvan de eerste tag deze slug heeft image_ratios: { poster: "4:3" }
Sleutel Wat hij regelt
title, description, version, author Getoond op de pagina Thema’s in het beheer.
meta.supports_dark_mode, meta.responsive, meta.categories Beschrijvend; gebruikt voor de themagalerij.
meta.social_image Een bestand in de static/ van het thema, 1200x630, gebruikt als voorbeeldafbeelding wanneer een pagina geen eigen omslagafbeelding heeft. Zonder dit wordt zo'n pagina gedeeld met het 180x180-icoon.
settings Wat je maar wilt. Wordt aan elk sjabloon doorgegeven als theme_settings, zodat een kleur of een slogan hier kan wonen in plaats van in de CSS.
home, page, post, tag De berichtenlijst die dat sjabloontype krijgt: posts (hoeveel), order_by, en of has_pagination echte paginalinks toevoegt of de lijst gewoon afkapt.
order_by -published_at (nieuwste eerst) of published_at; hetzelfde voor created_at en updated_at, met of zonder de - vooraan; of random.
image_ratios Wat de bijsnijder in het beheer aanbiedt bij het bewerken van dat inhoudstype: een verhouding zoals 16:9, een lijst daarvan, of free. Aparte waarden voor poster en gallery.
page-<slug>, post-<tag-slug> Dezelfde sleutels, die page/post overschrijven voor één pagina (via haar slug in de hoofdtaal) of voor berichten waarvan de eerste tag die slug heeft.