Recherche

Schéma des frontmatters

Source de vérité pour la validation automatique (_scripts/frontmatter-rules.yaml) et le développement.

Champs communs à toutes les collections

Champ Type Description
draft boolean Si true, la fiche est exclue de la production
pubdate string YYYY-MM-DD Date de publication. Requis pour apparaître en production
sources liste de string Clés de sources (voir _data/Sources.json)
omit_index boolean Exclut la fiche de l'index et du flux RSS
omit_replace boolean Désactive les remplacements de texte automatiques
note string Note interne (non affichée sur le site)

Persons

Fichiers : Persons/*.md Champ requis : name

Champ Type Description
name string (requis) Nom de référence en pinyin/romanisation principale
rōmaji string Transcription japonaise (Hepburn)
pinyin string Transcription chinoise (pinyin avec tons)
hànzì string Caractères chinois traditionnels
hànzì_simplified string Caractères chinois simplifiés
Wades_Giles string Transcription Wade-Giles (forme canonique)
sanskrit string Nom en translittération sanskrit
pāli string Nom en translittération pāli
pāli_simplified string Version simplifiée du pāli
devanāgarī string Écriture devanāgarī
tibetan string Translittération tibétaine
mongol string Transcription mongole
korean string Transcription coréenne
vietnamese string Transcription vietnamienne
dates string Dates de vie, ex. 709–788
master liste de string PKs des maîtres (référence vers Persons/*.md)
school string École zen : sōtō, rinzai, caodong…
patriarch string Lignée patriarcale : sōtō, rinzai…
portrait string Nom de fichier de l'image dans assets/img/
summary string Résumé court (affiché dans les listes)
koan_transmission string PK du kōan emblématique de transmission
dila string Identifiant dans la base DILA
alias string ou liste Noms alternatifs
french string Traduction française du nom
name_simplified string Version simplifiée du nom de référence
tags liste de string Tags internes (usage interne, ex. Opus)

Clés dépréciées / à normaliser :

Biographies

Fichiers : Biographies/*.md Convention de nommage : [Nom] PP.md (source primaire) ou [Nom] 5L.md (Cinq Lampes) Champ requis : person

Champ Type Description
person string (requis) PK de la fiche Person liée (Persons/[person].md)
compilation string PK de la compilation principale (ex. Wudeng huiyuan)
texts liste de string PKs de textes liés (ex. S55 - Jippō)
title string Titre explicite (sinon dérivé du nom du fichier)
author string Auteur si biographie secondaire

Structure du corps : sections séparées par ---. Le contenu avant le premier --- est l'introduction (affiché via beforeHr).

Koans

Fichiers : Koans/*.md Convention de nommage : [NomMaitre]-[n].md ou [Compilation]-[n].md Champ requis : title

Champ Type Description
title string (requis) Titre du kōan
persons liste de string PKs des personnes présentes dans le kōan
compilations objet { NomCompilation: [n°] } — numéros dans chaque recueil

Note : masters est une clé dépréciée → utiliser persons.

Texts

Fichiers : Texts/*.md Champ requis : title

Champ Type Description
title string (requis) Titre du texte
author string PK de l'auteur (référence vers Persons)
dates string Date de composition
hànzì string Titre en caractères chinois traditionnels
hànzì_simplified string Titre en caractères chinois simplifiés
rōmaji string Titre en romaji
pinyin string Titre en pinyin
english string Titre anglais
french string Titre français
taisho string Référence Taishō Tripiṭaka
koans liste de string PKs des kōans contenus dans ce texte
persons liste de string PKs des personnes mentionnées
compilations objet Compilations dont ce texte fait partie
translation boolean Indique si c'est une traduction
tags liste de string Tags internes (ex. Opus)

Clés dépréciées :

Compilations

Fichiers : Compilations/*.md Champ requis : title

Champ Type Description
title string (requis) Titre de la compilation
author string PK de l'auteur
dates string Date de composition
hànzì string Titre en caractères traditionnels
hànzì_simplified string Titre en caractères simplifiés
rōmaji string Titre en romaji
pinyin string Titre en pinyin
english string Titre anglais
french string Titre français
summary string Résumé court de la compilation
taisho string Référence Taishō Tripiṭaka
wikisource string URL Wikisource
translation boolean Indique si c'est une traduction

Pages

Fichiers : Pages/*.md Champ requis : title

Champ Type Description
title string (requis) Titre de la page
layout string Template Nunjucks (défaut : page.html)
permalink string URL explicite
eleventyExcludeFromCollections boolean Exclut du système de collections 11ty
index_collection string Collection à lister sur une page d'index (ex. Koans)

Validation automatique

npm run lint:frontmatter          # Vérifie les champs requis et les types
npm run lint:frontmatter:strict   # + vérifie les clés inconnues
npm run lint:md                   # Linting Markdown (markdownlint-cli2)
npm run lint                      # Les deux

Config : _scripts/frontmatter-rules.yaml Validator : _scripts/validate_frontmatter.ts Markdownlint : .markdownlint.json