Frontmatter

Le bloc YAML en tête de chaque fichier de contenu. Juicer lit un ensemble fixe de clés ; tout le reste est transmis aux gabarits comme .page.<key>. Cette page catalogue les clés de niveau moteur (lues par juicer lui-même) et pointe vers les clés propres aux thèmes (lues par un thème fourni chacune, documentées sous la section de ce thème).

---
title: Hello, World
date: 2024-03-12
tags: [intro, meta]
summary: A short description used in list pages and OpenGraph tags.
draft: false
---

The body of the page goes here.

Clés de niveau moteur

Celles-ci sont lues par juicer lui-même. Chaque thème fourni peut compter sur leur présence (ou leur normalisation vers un défaut sensé) sur chaque enregistrement de page dans les gabarits.

Identité de page

Publication et visibilité

---
title: Big announcement
date: 2024-12-25T09:00:00Z
draft: false
---

---
title: About this site
static: true
---

Taxonomie

---
title: Functional programming in Scala 3
tags: [scala, functional, language]
categories: tutorials
---

Slugification : minuscules → repli ASCII (café → cafe) → suites de caractères non alphanumériques → -. Ainsi "Functional Programming" devient functional-programming.

Ordonnancement

Auteurs

---
title: A co-authored post
authors: [ed, alice]
---

Les IDs d’auteur qui ne correspondent à aucun [[authors]].id retombent sur un enregistrement embryonnaire {id: "<typo>"} pour que les gabarits n’échouent pas ; l’archive par auteur est vide dans ce cas.

Séries

---
title: OS Internals, Part 1
series: OS Internals
seriesOrder: 1
---

Alias (redirections)

---
title: Setting up a Scala 3 project
aliases:
  - /old-blog-name/setting-up-scala/
  - /2023/setting-up/
---

Chaque alias doit inclure les barres obliques de tête et de fin : /old-url/, pas old-url ni /old-url.

Événements

Ces clés sont lues sur les pages de l’eventsSection (par défaut events) — la section que juicer traite comme la source des événements de calendrier.

---
title: Tuesday Coffee
date: 2024-03-12T09:00:00
recurring: weekly
recurringDay: Tuesday
---

Photos

---
title: Picnic in the park
date: 2024-06-12
photos:
  - "/img/picnic-01.jpg"
  - { src: "/img/picnic-02.jpg", caption: "The pie table", alt: "A long folding table loaded with summer pies" }
---

OpenGraph / cartes sociales

Celles-ci supplantent les valeurs par défaut que l’assistant de gabarit ogTags calcule autrement à partir de .page.title, .page.summary, .page.image, etc.

---
title: A long, descriptive, SEO-targeted post title
summary: A long summary tuned for the page's own list rendering.
ogTitle: A short, punchy title for social cards
ogDescription: A different summary that fits in a card preview.
ogImage: /img/posts/short-title-card.png
---

Calculées (non définies par vous)

Ces champs apparaissent sur .page.<key> dans les gabarits mais ne sont pas lus depuis le frontmatter — ils sont définis par juicer pendant la construction :

La référence complète de .page, incluant celles-ci, réside dans Données de gabarit → .page.

Cascade — frontmatter hérité

Le _index.md d’une section peut déclarer une carte cascade: ; chaque clé à l’intérieur est héritée par chaque page descendante qui ne définit pas la même clé dans son propre frontmatter. Cela permet à une section d’établir des valeurs par défaut — auteur, layout, licence, drapeaux personnalisés — sans les répéter sur chaque page.

# content/posts/_index.md
---
title: Posts
cascade:
  author: ed
  tone: editorial
  license: CC-BY
---

Chaque page sous /posts/ reprend maintenant .page.author = "ed", .page.tone = "editorial", .page.license = "CC-BY" automatiquement. Un article spécifique peut supplanter n’importe lequel d’entre eux :

# content/posts/guest-piece.md
---
title: Guest piece
author: alice    # overrides the cascaded "ed"
---

Règles de résolution

• Le frontmatter propre à la page l’emporte sur toute valeur de cascade.
• Les ancêtres plus proches l’emportent sur les ancêtres plus lointains. La cascade du _index.md racine est la plus faible ; la cascade d’une section profondément imbriquée supplante tout ce qui est au-dessus d’elle.
• La cascade d’une section ne s’applique PAS à son propre _index.md. La cascade déclare des valeurs par défaut pour les descendants, pas pour la page qui la déclare. Le _index.md propre à la section n’hérite que des cascades des sections au-dessus de lui.
• Les sections héritent de la cascade des sections ancêtres. Le _index.md d’une section imbriquée reprend les cascades de chaque section ancêtre, puis fusionne les siennes (les siennes l’emportent).
• Une cascade absente / vide est sans effet. Les pages sans aucune cascade dans leur chaîne d’ancêtres voient exactement le frontmatter qu’elles ont écrit.

Ce qui peut être mis en cascade

Toute clé de frontmatter que le moteur ou un thème lit. Candidats utiles :

• author / authors — attribution à l’échelle de la section.
• layout — force chaque page d’une section par un gabarit spécifique (p. ex. layout: project à travers une section de portfolio).
• tags / categories — taxonomie à l’échelle de la section ; les pages ajoutent les leurs et supplantent la liste par défaut au besoin.
• Clés personnalisées consommées par votre thème — tone, region, license, noindex, …

Moins utile (mais légal) à mettre en cascade : date, title, summary — celles-ci sont intrinsèquement par page et bénéficient rarement d’un défaut. Il n’y a aucune contrainte ; la cascade est un mécanisme général et l’auteur est responsable de choisir des clés qui ont du sens à hériter.

Frontmatter propre au thème

Les thèmes fournis reconnaissent leurs propres clés de frontmatter par-dessus la surface du moteur. Celles-ci sont documentées par thème :

Toute autre clé

Tout ce que vous écrivez dans le frontmatter que juicer ne lit pas est exposé sur .page.<key> pour usage dans les gabarits. Ainsi ajouter un champ personnalisé est simplement une question de l’écrire :

---
title: Cherry pie
yield: 8 servings
prepTime: 45 min
cookTime: 1 h 10 min
---

<dl>
  <dt>Yield</dt><dd>{{ .page.yield }}</dd>
  <dt>Prep time</dt><dd>{{ .page.prepTime }}</dd>
  <dt>Cook time</dt><dd>{{ .page.cookTime }}</dd>
</dl>