Sur cette page

• Variables prédéfinies
• updated
• menu
• Taxonomie
• Planification
• redirect
• alias
• output
• external
• excluded

Front matter

Le front matter peut contenir des variables personnalisées appliquées à la page courante.

Il doit se trouver au tout début du fichier et être un YAML valide.

Variables prédéfinies

Variable	Description	Valeur par défaut	Exemple
title	Titre	Nom de fichier sans extension.	Post 1
layout	Template	Voir Lookup rules.	404
date	Date de création	Date de création du fichier (objet PHP DateTime).	2019/04/15
section	Section	Section de la page.	blog
path	Chemin	Path de la page.	blog/post-1
slug	Slug	Slug de la page.	post-1
published	Publié ou non	true.	false
draft	Brouillon ou non	false.	true

updated

La variable updated sert à définir la date de dernière modification d’une page.

Exemple :

---
updated: 2026-02-02
---

menu

Une page peut être ajoutée à un menu.

Le nom de l’entrée est le title de la page et l’URL est le path de la page.

La même page peut être ajoutée à plusieurs menus, et la position de chaque entrée peut être définie avec la clé weight (la plus faible en premier). La clé name peut être utilisée pour personnaliser le nom de l’entrée par menu.

Exemples :

---
menu: main
---

---
menu: [main, navigation] # same page in multiple menus
---

---
menu:
  main:
    weight: 10
  navigation:
    weight: 20
---

---
title: 'Notre expertise'
menu:
  main:
    weight: 15
  footer:
    weight: 15
    name: "Expertise" # personnalise le nom de l'entrée dans ce menu
---

Taxonomie

La taxonomie permet de connecter, relier et classer le contenu de votre site Web.
Dans Cecil, ces termes sont regroupés dans des vocabulaires.

Les vocabulaires sont déclarés dans la Configuration.

Vocabulaire

Une catégorisation du contenu (ex. : tags, categories, etc.).

Terme

Un terme est un élément d’un vocabulaire (ex. : Développement, PHP, etc.).

Exemple :

---
tags: ["Développement", "PHP"]
---

Cecil génère ensuite, pour chaque vocabulaire :

• une page listant ses termes, ex. : /tags/
• une page par terme listant ses pages, ex. : /tags/developpement/ et /tags/php/

Voir les règles de recherche des templates et les variables de taxonomie pour personnaliser ces pages.

Planification

Planifie la publication des pages.

Exemple :

La page sera publiée si la date courante est >= 2023-02-07 :

schedule:
  publish: 2023-02-07

Cette page est publiée si la date courante est <= 2022-04-28 :

schedule:
  expiry: 2022-04-28

redirect

Comme son nom l’indique, la variable redirect sert à rediriger une page vers une URL dédiée.

Exemple :

---
redirect: "https://arnaudligny.fr"
---

alias

Un alias est une redirection vers la page courante.

Exemple :

---
title: "About"
alias:
  - contact
---

Dans l’exemple précédent, contact/ redirige vers about/.

output

Définit le format de sortie de la page.

Les formats disponibles sont : html, atom, rss, json, xml, etc.
Vous pouvez définir un ou plusieurs formats dans un tableau.

Il n’est pas obligatoire de définir un format de sortie, mais si vous le faites, il doit correspondre à l’un des formats disponibles définis dans la Configuration.

Exemple :

---
output: [html, atom]
---

external

Une page avec une variable external tente de récupérer le contenu de la ressource ciblée.

Exemple :

---
external: "https://raw.githubusercontent.com/Cecilapp/Cecil/main/README.md"
---

excluded

Définissez excluded à true pour masquer une page des pages de liste (c.-à-d. : Home page, Section, Sitemap, etc.).

Exemple :

---
excluded: true
---