Aquí es donde un tema se describe y configura unos cuantos comportamientos, sin tocar ninguna plantilla. Esto es lo que usan los temas incluidos:
title: "Ink" description: "Un tema limpio y minimalista" version: "1.0.0" author: "FolioPress"
meta: supports_dark_mode: true responsive: true categories: [minimal, portfolio]
settings: # libre; disponible en las plantillas como theme_settings primary_color: "#2563eb"
home: posts: 10 # cuántas entradas recibe la página de inicio order_by: "-published_at" # las más recientes primero has_pagination: false # ¿un corte, o enlaces de página reales? image_ratios: poster: "16:9" # lo que ofrece el recortador de imágenes de la administración aquí gallery: "free"
page: { posts: 10, order_by: "-published_at", has_pagination: false } post: { posts: 3, order_by: "-published_at" } # entradas relacionadas bajo una entrada tag: { posts: 12, order_by: "-published_at", has_pagination: true }
page-about: # anulación para una página, por su slug en el idioma principal image_ratios: { poster: "1:1" } post-tutorials: # anulación para las entradas cuya primera etiqueta tiene este slug image_ratios: { poster: "4:3" }
Clave Qué controla
title, description, version, author Se muestran en la página Temas de la administración.
meta.supports_dark_mode, meta.responsive, meta.categories Descriptivos; se usan en la galería de temas.
meta.social_image Un archivo en static/ del tema, de 1200x630, usado como imagen de vista previa cuando una página no tiene imagen de portada propia. Sin él, esa página se comparte con el icono de 180x180.
settings Lo que quieras. Se entrega a todas las plantillas como theme_settings, para que un color o un lema puedan vivir aquí en lugar de en el CSS.
home, page, post, tag La lista de entradas que recibe ese tipo de plantilla: posts (cuántas), order_by, y si has_pagination añade enlaces de página reales o simplemente corta la lista.
order_by -published_at (las más recientes primero) o published_at; igual con created_at y updated_at, con o sin el - inicial; o random.
image_ratios Lo que ofrece el recortador de imágenes de la administración al editar ese tipo de contenido: una proporción como 16:9, una lista de ellas, o free. Valores separados para poster y gallery.
page-<slug>, post-<tag-slug> Las mismas claves, anulando page/post para una página (por su slug en el idioma principal) o para las entradas cuya primera etiqueta tiene ese slug.