Creare temi

theme.yml: il pannello delle impostazioni

È qui che un tema si descrive e configura alcuni comportamenti, senza toccare un template. Ecco cosa usano i temi inclusi:

title: "Ink" description: "Un tema pulito e minimale" version: "1.0.0" author: "FolioPress"

meta: supports_dark_mode: true responsive: true categories: [minimal, portfolio]

settings: # libero; disponibile nei template come theme_settings primary_color: "#2563eb"

home: posts: 10 # quanti articoli riceve la pagina iniziale order_by: "-published_at" # i più recenti prima has_pagination: false # un taglio, o veri collegamenti di pagina? image_ratios: poster: "16:9" # cosa offre qui lo strumento di ritaglio dell’amministrazione gallery: "free"

page: { posts: 10, order_by: "-published_at", has_pagination: false } post: { posts: 3, order_by: "-published_at" } # articoli correlati sotto un articolo tag: { posts: 12, order_by: "-published_at", has_pagination: true }

page-about: # override per una pagina, tramite il suo slug nella lingua principale image_ratios: { poster: "1:1" } post-tutorials: # override per gli articoli il cui primo tag ha questo slug image_ratios: { poster: "4:3" }

Chiave Cosa controlla

title, description, version, author Mostrati nella pagina Temi dell’amministrazione.

meta.supports_dark_mode, meta.responsive, meta.categories Descrittivi; usati per la galleria dei temi.

meta.social_image Un file nella cartella static/ del tema, 1200x630, usato come immagine di anteprima quando una pagina non ha un'immagine di copertina propria. Senza, quella pagina viene condivisa con l'icona da 180x180.

settings Quello che vuoi. Consegnato a ogni template come theme_settings, così un colore o uno slogan può vivere qui invece che nel CSS.

home, page, post, tag L’elenco di articoli che riceve quel tipo di template: posts (quanti), order_by, e se has_pagination aggiunge veri collegamenti di pagina o taglia semplicemente l’elenco.

order_by -published_at (i più recenti prima) o published_at; lo stesso per created_at e updated_at, con o senza il - iniziale; oppure random.

image_ratios Cosa offre lo strumento di ritaglio dell’amministrazione quando si modifica quel tipo di contenuto: una proporzione come 16:9, un elenco di proporzioni, o free. Valori distinti per poster e gallery.

page-<slug>, post-<tag-slug> Le stesse chiavi, che sovrascrivono page/post per una pagina (tramite il suo slug nella lingua principale) o per gli articoli il cui primo tag ha quello slug.

Serve ancora aiuto? Scrivici dal pannello del tuo sito (Assistenza) o a support@foliopress.io.