Hier beschreibt sich ein Theme selbst und legt ein paar Verhaltensweisen fest, ohne ein Template anzufassen. So nutzen es die mitgelieferten Themes:
title: "Ink" description: "Ein klares, minimalistisches Theme" version: "1.0.0" author: "FolioPress"
meta: supports_dark_mode: true responsive: true categories: [minimal, portfolio]
settings: # frei; in Templates als theme_settings verfügbar primary_color: "#2563eb"
home: posts: 10 # wie viele Beiträge die Startseite bekommt order_by: "-published_at" # neueste zuerst has_pagination: false # ein Abschnitt, oder echte Seitenlinks? image_ratios: poster: "16:9" # was der Bildzuschnitt der Verwaltung hier anbietet gallery: "free"
page: { posts: 10, order_by: "-published_at", has_pagination: false } post: { posts: 3, order_by: "-published_at" } # verwandte Beiträge unter einem Beitrag tag: { posts: 12, order_by: "-published_at", has_pagination: true }
page-about: # Überschreibung für eine Seite, per Slug in der Hauptsprache image_ratios: { poster: "1:1" } post-tutorials: # Überschreibung für Beiträge, deren erster Tag diesen Slug hat image_ratios: { poster: "4:3" }
Schlüssel Was er steuert
title, description, version, author Werden auf der Seite Themes der Verwaltung angezeigt.
meta.supports_dark_mode, meta.responsive, meta.categories Beschreibend; für die Theme-Galerie.
meta.social_image Eine Datei im static/ des Themes, 1200x630, als Vorschaubild verwendet, wenn eine Seite kein eigenes Titelbild hat. Ohne sie wird eine solche Seite mit dem 180x180-Icon geteilt.
settings Was immer du möchtest. Wird jedem Template als theme_settings übergeben, sodass eine Farbe oder ein Slogan hier statt im CSS leben kann.
home, page, post, tag Die Beitragsliste, die dieser Template-Typ bekommt: posts (wie viele), order_by, und ob has_pagination echte Seitenlinks ergänzt oder die Liste nur abschneidet.
order_by -published_at (neueste zuerst) oder published_at; ebenso created_at und updated_at, mit oder ohne führendes -; oder random.
image_ratios Was der Bildzuschnitt der Verwaltung beim Bearbeiten dieses Inhaltstyps anbietet: ein Verhältnis wie 16:9, eine Liste davon oder free. Getrennte Werte für poster und gallery.
page-<slug>, post-<tag-slug> Dieselben Schlüssel, die page/post für eine Seite (per Slug in der Hauptsprache) oder für Beiträge überschreiben, deren erster Tag diesen Slug trägt.