# 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](https://en.wikipedia.org/wiki/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_](../templates/10-lookup-rules.fr.md#regles-de-recherche). | `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`        |

:::info
Toutes les variables prédéfinies peuvent être surchargées, sauf `section`.
:::

## updated

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

_Exemple :_

```yaml
---
updated: 2026-02-02
---
```

:::warning
Avant la version 8.80.1, la variable `updated` était une variable prédéfinie. Elle est désormais optionnelle (et doit être définie dans le front matter pour être utilisée).
:::

## menu

Une page peut être ajoutée à un [menu](../configuration/22-site.fr.md#menus).

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 :_

```yaml
---
menu: main
---
```

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

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

```yaml
---
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_](../configuration/22-site.fr.md#taxonomies).

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 :_

```yaml
---
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](../templates/10-lookup-rules.fr.md#type-vocabulary) et les [variables de taxonomie](../templates/11-variables.fr.md#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 :

```yaml
schedule:
  publish: 2023-02-07
```

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

```yaml
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 :_

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

:::info
La redirection fonctionne avec le template [`redirect.html.twig`](https://github.com/Cecilapp/Cecil/blob/main/resources/layouts/_default/redirect.html.twig).
:::

## alias

Un alias est une redirection vers la page courante.

_Exemple :_

```yaml
---
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_](../configuration/29-output.fr.md#output-formats).

_Exemple :_

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

## external

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

_Exemple :_

```yaml
---
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 :_

```yaml
---
excluded: true
---
```

:::info
`excluded` est différent de [`published`](#variables-predefinies) : une page exclue est publiée, mais masquée des pages de liste.
:::

:::warning
Depuis la version 8.49.0, l’ancienne variable `exclude` a été remplacée par `excluded`.
:::