Fragments (includes)

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

  • browsehappy.twig et favicon.twig sont inclus tels quels dans le layout de base et ne demandent pas de personnalisation.
  • le répertoire styleguide/ accueille les fragments et modèles qui serviront à alimenter le styleguide.
  • le répertoire macros/ réunit les macros génériques utilisées sur le projet.

À savoir : le chemin des includes 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 includes 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 %}

Les informations données dans cette rubrique correspondent à la version 1.0 release candidate de Scampi-Twig, encore en développement. Pour lire la documentation de la version courante (0.3.1), référez-vous au readme du dépôt.