Sur cette page
Étendre les templates
Les templates peuvent être étendus avec des fonctions et filtres personnalisés, ou regroupés dans un thème réutilisable.
Fonctions et filtres
Vous pouvez ajouter des fonctions et des filtres personnalisés avec une extension Twig.
Thème
Il est simple de créer un thème : il suffit de créer un dossier <theme> avec la structure suivante (comme un site web, mais sans pages) :
<mon-site>
└─ themes
└─ <theme>
├─ config.yml
├─ assets
├─ layouts
├─ schemas
├─ static
└─ translations
Activez-le ensuite avec l’option de configuration theme.
Le fichier config.yml du thème surcharge la configuration par défaut et est fusionné avec la configuration du site, qui est prioritaire, sauf pour les listes de valeurs : les valeurs du site s’ajoutent à celles du thème, et une valeur du thème ne peut être retirée qu’avec false (ex. homepage: {atom: false}).
Le dossier schemas du thème contient les schémas du front matter des variables attendues par ses templates : les schémas du site les surchargent variable par variable.
Thèmes requis
Un thème peut requérir d’autres thèmes (ex. un thème composant fournissant un champ de recherche, ou un plugin) avec l’option theme de son config.yml :
/themes/<theme>/config.yml
theme:
- <theme-requis>
Les thèmes requis sont activés avec le thème, sans autre configuration du site : leurs layouts, assets, fichiers statiques, traductions, extensions et config.yml sont chargés. Ils sont ajoutés après les thèmes du site : le thème (comme le site) surcharge donc les thèmes qu’il requiert.