Fragments (includes)

Les fichiers qui seront inclus dans les pages ou les layouts sont placés dans le répertoire templates/common/.

  • block-browsehappy.twig et block-favicon.twig sont inclus tels quels dans le layout de base et ne demandent pas de personnalisation.
  • macro-generic réunit les macros génériques utilisées sur le projet.

Par ailleurs, le répertoire templates/styleguide/ accueille les fragments et modèles qui serviront à alimenter le styleguide.

À savoir : le chemin des fragments est calculé depuis l'index du répertoire templates.

Il est conseillé de préfixer les fichiers propres au projet afin de pouvoir facilement distinguer les originels de scampi-twig et ceux qui ont été spécifiquement créés.

Si nécessaire, des sous-répertoires peuvent être créés pour catégoriser les fragments en fonction des besoins.

S'il existe de nombreux fichiers de contenus à inclure - notamment dans le cas de la création d'un site statique - on les placera plutôt dans un répertoire dédié (par exemple content) au même niveau que templates/ et pages/.

L'inclusion d'un fichier markdown doit être précédé et suivi des balises twig idoines :

{% markdown 'chemin/relatif/vers/fichier/md' %}{% endmarkdown %}