Utilise maintenant Zola v0.23.1

This commit is contained in:
julien
2026-08-06 20:23:55 +02:00
parent 1767245f10
commit d7b8aeab93
30 changed files with 759 additions and 1170 deletions
+185 -177
View File
@@ -1,17 +1,19 @@
# Guide de rédaction
Ce guide explique comment créer, compléter, mettre à jour et publier les contenus de **Les Carnets dAkkadien**.
Ce guide décrit la création, la mise à jour et la publication des fiches du site **Les Carnets dAkkadien**.
Le principe général est simple :
Le principe est le suivant :
- le front matter TOML contient les données brèves et structurées ;
- le corps Markdown contient les explications, tableaux, exemples et commentaires ;
- les champs prévus par un modèle restent présents, même lorsquils sont vides ;
- les champs optionnels vides sont généralement omis du rendu ; les champs structurels restent néanmoins présents dans le front matter.
- le front matter TOML contient les données courtes et structurées ;
- le corps Markdown contient les explications, exemples, tableaux et commentaires ;
- tous les champs prévus par le modèle restent présents, même lorsquils sont vides ;
- les valeurs vides sont généralement omises du rendu.
Toutes les commandes sont exécutées depuis la racine du dépôt.
## Organisation des contenus
## Périmètre des outils
Les fiches se trouvent dans cinq sections :
| Type | Répertoire | Taxonomie |
|---|---|---|
@@ -21,35 +23,45 @@ Toutes les commandes sont exécutées depuis la racine du dépôt.
| Texte | `src/content/textes/` | `genres` |
| Vocabulaire | `src/content/vocabulaire/` | `natures` |
La bibliographie et les mentions légales sont des pages autonomes placées directement dans `src/content/`. Les trois scripts de fiches ne les créent, ne les modifient et ne les valident pas.
Les fichiers `_index.md` définissent les sections et restent maintenus manuellement. Les pages autonomes placées directement dans `src/content/`, comme la bibliographie et les mentions légales, ne sont ni créées, ni horodatées, ni validées par les scripts de fiches.
Chaque section contient un fichier `_index.md` qui définit son titre, sa description, son tri et ses templates. Ces index sont maintenus manuellement ; le générateur crée uniquement des pages de contenu.
Les commandes publiques sont :
- `new-content.py` : création dun brouillon ;
- `update-content.py` : mise à jour de lhorodatage `updated` ;
- `check-content.py` : validation structurelle des fiches.
`_schema.py` est leur module commun et ne se lance pas directement.
## Cycle de rédaction
1. créer un brouillon avec `new-content.py` ;
2. compléter le front matter et le corps Markdown ;
3. vérifier localement la fiche avec les brouillons affichés ;
4. passer `draft` à `false` lorsque la fiche est prête ;
5. lancer le validateur et la vérification Zola ;
6. après une modification substantielle ultérieure, actualiser `updated` avec `update-content.py`.
2. compléter les données et le corps Markdown ;
3. contrôler son rendu avec les brouillons ;
4. passer `draft` à `false` lorsquil est prêt ;
5. exécuter les validations et construire la version publique ;
6. après une modification substantielle ultérieure, actualiser `updated`.
Afficher les brouillons localement :
Pendant la rédaction :
```sh
zola --root src serve --drafts
```
Contrôler la structure des fiches et la construction du site avant publication :
Avant publication :
```sh
./scripts/check-content.py
zola --root src check --drafts --skip-external-links
zola --root src check --drafts
zola --root src build --drafts
zola --root src build
```
`zola check` contrôle le chargement du site et ses liens. Les deux constructions suivantes vérifient réellement le rendu de tous les brouillons, puis celui de la version publique. En labsence daccès réseau, ajouter `--skip-external-links` à la commande `zola check`.
## Créer une fiche
La commande générale est :
Syntaxe générale :
```sh
./scripts/new-content.py SECTION IDENTIFIANT [--nature NATURE] [--title TITRE]
@@ -74,25 +86,29 @@ nom, adjectif, verbe, pronom, préposition,
adverbe, conjonction, particule, numéral
```
Lorsque `--nature` est omise dans un terminal interactif, le générateur propose un menu. Elle est obligatoire dans un contexte non interactif.
Dans un terminal interactif, lomission de `--nature` ouvre un menu. Dans un contexte non interactif, loption est obligatoire.
Le générateur normalise lidentifiant et le titre en Unicode NFC, prépare tous les champs nécessaires et refuse d’écraser un fichier existant. Il ne renseigne pas les données linguistiques et ne rédige pas le corps Markdown.
Le générateur :
Pour un article, un texte ou une note de grammaire, le titre est déduit de lidentifiant en remplaçant les tirets par des espaces et en mettant linitiale en majuscule. Pour le vocabulaire, il reprend lidentifiant. Pour un signe, il reste vide sauf si `--title` est fourni.
- normalise lidentifiant et le titre en Unicode NFC ;
- crée tous les champs prévus par le modèle ;
- initialise la fiche comme brouillon ;
- refuse d’écraser un fichier existant ;
- ne renseigne aucune donnée linguistique et ne rédige pas le corps Markdown.
Le titre est déduit de lidentifiant pour les articles, la grammaire et les textes. Pour le vocabulaire, il reprend lidentifiant. Pour un signe, il reste vide sauf si `--title` est fourni.
## Conventions générales
### Période et terminologie
Le site est principalement consacré au paléo-babylonien. Une forme, une graphie ou une analyse relevant dune autre période ou dun autre dialecte est signalée dans la fiche concernée.
Le site est principalement consacré au paléo-babylonien. Toute forme, graphie ou analyse relevant dune autre période ou dun autre dialecte est signalée dans la fiche concernée.
Les clés du front matter sont en anglais. Les noms des taxonomies sont en français ; leurs termes suivent la donnée affichée, en français pour les catégories et en translittération pour les lectures.
Les clés du front matter sont en anglais. Les taxonomies portent des noms français. Les lectures conservent exactement leur translittération.
### Unicode et translittération
Tous les fichiers de contenu sont enregistrés en UTF-8 et normalisés en Unicode NFC, y compris leurs noms.
Les lemmes, lectures et formes akkadiennes conservent leurs diacritiques :
Les sources sont enregistrées en UTF-8 et utilisent la normalisation Unicode NFC. Les lemmes, lectures et formes akkadiennes conservent leurs diacritiques :
```text
bītum
@@ -101,17 +117,16 @@ aš
ṭim
```
Dans le corps Markdown, les formes linguistiques sont généralement écrites en *italique*. Le code en ligne est réser aux commandes, chemins et noms de champs.
Dans le corps Markdown, les formes linguistiques sont généralement écrites en *italique*. Le code en ligne sert aux commandes, chemins et noms de champs.
### Noms de fichiers
### Identifiants et noms de fichiers
Pour les articles, la grammaire, les textes et le vocabulaire, lidentifiant fourni au générateur devient le nom du fichier. Il doit être écrit sous sa forme finale :
Pour les articles, la grammaire, les textes et le vocabulaire, lidentifiant devient le nom du fichier. Il doit être fourni sans extension et respecter les règles suivantes :
- en minuscules ;
- sans espace ni underscore ;
- avec seulement des lettres Unicode, des chiffres et des tirets ;
- sans double tiret ni tiret final ;
- sans extension `.md`.
- minuscules uniquement ;
- aucun espace ni underscore ;
- lettres Unicode, chiffres et tirets seulement ;
- aucun double tiret ni tiret final.
Exemples :
@@ -124,7 +139,7 @@ src/content/articles/les-carnets-sont-en-ligne.md
Un tiret initial est accepté uniquement pour le vocabulaire, par exemple `-ma.md`.
Les signes utilisent toujours un numéro MZL sur trois chiffres :
Les signes utilisent un numéro MZL compris entre 1 et 999. Le générateur produit automatiquement un nom sur trois chiffres :
```text
src/content/signes/mzl-001.md
@@ -132,120 +147,125 @@ src/content/signes/mzl-113.md
src/content/signes/mzl-167.md
```
Les chemins et les termes de taxonomie utilisent la stratégie de slugification `safe` de Zola. Les diacritiques sont donc conservés : `tim` et `ṭim` restent distincts.
Zola utilise la stratégie de slugification `safe`, afin de conserver notamment la distinction entre `tim` et `ṭim`.
### Taxonomies
Les taxonomies publiques sont :
- `natures` pour le vocabulaire ;
- `lectures` pour les signes ;
- `themes` pour la grammaire ;
- `genres` pour les textes.
Une fiche de vocabulaire contient exactement une nature reconnue, car elle détermine son modèle de champs. Les autres taxonomies peuvent contenir plusieurs termes.
Dans `themes` et `genres`, les termes composés utilisent des tirets :
```toml
natures = ["préposition"]
lectures = ["tim", "ṭim"]
themes = ["morphologie-nominale"]
genres = ["inscription-commémorative"]
```
Les templates rétablissent les espaces à laffichage, tandis que les URL restent sans espace :
```text
/themes/morphologie-nominale/
/genres/inscription-commémorative/
```
La graphie dun terme doit rester stable après sa publication.
## Front matter commun
Le générateur place les éléments suivants en tête de chaque fiche :
Chaque fiche créée par le générateur commence par :
```toml
title = "Titre"
date = 2026-08-05T12:30:00+02:00
date = 2026-08-06T12:30:00+02:00
# updated = YYYY-MM-DDTHH:MM:SS+HH:MM
description = ""
draft = true
```
Les tables propres au type de contenu viennent ensuite dans le même front matter.
- `title` : titre affiché ;
- `date` : horodatage initial et date de publication ;
- `updated` : dernière modification substantielle ;
- `description` : résumé court facultatif ;
- `draft` : état de publication.
- `title` est le titre affiché ;
- `date` est lhorodatage initial de la fiche et sert de date de publication ;
- `updated` est lhorodatage de la dernière modification substantielle ;
- `description` est un résumé court, rédigé manuellement lorsquil est utile ;
- `draft` détermine si la page est publiée.
`date` et `updated` sont des horodatages TOML sans guillemets, produits dans le fuseau `Europe/Paris`. Chaque fiche doit conserver **exactement une** ligne `updated`, commentée ou active.
`date` est un horodatage TOML sans guillemets, créé dans le fuseau `Europe/Paris`. La fiche doit toujours conserver exactement une ligne `updated`, commentée ou active.
Après une modification substantielle, lancer :
Pour actualiser une fiche :
```sh
./scripts/update-content.py src/content/vocabulaire/bītum.md
```
La forme abrégée, relative à `src/content/`, est également acceptée :
La forme relative à `src/content/` est également acceptée :
```sh
./scripts/update-content.py vocabulaire/bītum.md
```
Le chemin complet peut être saisi rapidement avec lautocomplétion du shell. Le script accepte uniquement les fiches Markdown placées dans une section connue ; il refuse donc les index, les pages situées directement dans `src/content/` et les fichiers extérieurs à ce répertoire. Il remplace ensuite lunique ligne `updated` par lheure courante de `Europe/Paris` :
Le script refuse les index, les pages autonomes et les chemins extérieurs aux cinq sections. Il remplace lunique ligne `updated` par lheure courante :
```toml
updated = 2026-08-05T16:47:00+02:00
updated = 2026-08-06T16:47:00+02:00
```
Sur la page daccueil, `updated` prime sur `date` pour classer les « Fiches récentes ». Il ne doit donc être activé quaprès une modification substantielle.
Sur la page daccueil, `updated` prime sur `date` pour le classement des trois fiches récentes. Il ne doit donc être activé quaprès une modification substantielle.
### Descriptions automatiques
Lorsque `description` reste vide :
- une fiche de vocabulaire affiche une phrase construite à partir de sa nature, de son genre et de son sens ;
- une fiche de signe affiche une phrase construite à partir de son titre et de son numéro MZL ;
- un article, une note de grammaire ou un texte naffiche pas de résumé de remplacement.
- une fiche de vocabulaire affiche un résumé construit à partir de sa nature, de son genre et de son sens ;
- une fiche de signe affiche son titre et son numéro MZL ;
- les autres fiches naffichent pas de résumé de remplacement dans leur contenu.
La métadescription HTML utilise alors, en dernier recours, la description générale du site.
Les mêmes résumés automatiques servent de métadescription aux fiches de vocabulaire et de signes. Pour les autres pages sans description spécifique, le template utilise la description générale du site.
## Brouillons et publication
Une description manuelle reste préférable lorsquelle apporte une information plus précise, notamment pour les articles, la grammaire et les textes.
Un brouillon peut conserver des valeurs vides, mais tous les champs de son modèle restent présents afin que sa structure puisse être vérifiée dès sa création. Pour publier une fiche :
### Brouillons
1. compléter les données disponibles sans supprimer les champs de son modèle ;
Un brouillon peut conserver des valeurs vides, mais tous les champs de son modèle restent présents. Pour publier une fiche :
1. compléter les informations disponibles ;
2. rédiger le corps Markdown ;
3. vérifier que `date` correspond à la publication souhaitée ;
3. vérifier la date souhaitée ;
4. remplacer `draft = true` par `draft = false` ;
5. lancer les contrôles indiqués dans le cycle de rédaction.
5. exécuter les contrôles du cycle de rédaction.
Une fiche temporairement retirée du site peut repasser à `draft = true`.
Une fiche publiée peut repasser temporairement à `draft = true`.
## Taxonomies
## Modèles de contenu
Les taxonomies publiques sont :
Les tables suivantes viennent après les champs communs, dans le même front matter délimité par `+++`.
- `natures` pour la nature grammaticale du vocabulaire ;
- `lectures` pour les lectures des signes ;
- `themes` pour les notions grammaticales ;
- `genres` pour les types documentaires des textes.
### Vocabulaire
Les termes sont écrits sous leur forme destinée à laffichage :
Toutes les fiches lexicales contiennent au minimum :
```toml
natures = ["préposition"]
lectures = ["tim", "ṭim"]
themes = ["morphologie nominale"]
genres = ["lettre"]
```
La graphie doit rester stable. Une fiche de vocabulaire contient exactement une nature connue, car cette valeur sélectionne le modèle de champs à contrôler. Les autres taxonomies peuvent contenir plusieurs termes lorsque cela est pertinent.
## Fiches de vocabulaire
Toutes les fiches lexicales utilisent la structure générale suivante :
```toml
+++
title = "lemme"
date = 2026-08-05T12:30:00+02:00
# updated = YYYY-MM-DDTHH:MM:SS+HH:MM
description = ""
draft = true
[extra]
meaning = ""
logograms = []
[taxonomies]
natures = ["nature"]
+++
```
`meaning` contient le sens principal ou une courte série de sens. Il est normalement renseigné avant publication, mais peut rester vide pendant la rédaction.
`logograms` reste toujours un tableau de chaînes :
`meaning` contient le sens principal ou une courte série de sens. `logograms` est toujours un tableau de chaînes :
```toml
logograms = ["LUGAL"]
```
Chaque nature ajoute les champs suivants, dans lordre produit par le générateur :
Chaque nature ajoute les champs suivants :
| Nature | Champs supplémentaires |
|---|---|
@@ -259,14 +279,14 @@ Chaque nature ajoute les champs suivants, dans lordre produit par le généra
| Particule | `function` |
| Numéral | `numeral_type`, `value`, `gender`, `feminine` |
Tous les champs simples restent des chaînes, même lorsquils sont vides. Chaque fiche, brouillon compris, doit conserver tous les champs prévus pour sa nature. Le validateur contrôle leur présence et leur type, sans imposer de valeur non vide ni refuser d’éventuels champs supplémentaires. Pour un verbe, le titre fournit déjà linfinitif et celui-ci nest donc pas répété dans `[extra]`.
Tous les champs simples sont des chaînes, même lorsquils sont vides. Pour un verbe, le titre fournit déjà linfinitif et celui-ci nest pas répété dans `[extra]`.
### Sens des principaux champs
Principaux champs :
- `gender` : genre grammatical ;
- `bound` : forme liée ;
- `plural` : pluriel lexical ;
- `predicative` : forme prédicative de référence, affichée comme « Prédicatif (3 m. s.) » ;
- `predicative` : forme affichée comme « Prédicatif (3 m. s.) » ;
- `root` : racine, par exemple `p-r-s` ;
- `stem` : thème verbal, par exemple `G`, `D`, `Š` ou `N` ;
- `verb_class` : classe morphologique, par exemple `fort`, `I-n` ou `III-faible` ;
@@ -274,10 +294,10 @@ Tous les champs simples restent des chaînes, même lorsquils sont vides. Cha
- `pronoun_type` : type de pronom ;
- `governs` : cas régi par une préposition ;
- `function` : fonction dun adverbe, dune conjonction ou dune particule ;
- `numeral_type` : cardinal, ordinal ou autre type de numéral ;
- `numeral_type` : cardinal, ordinal ou autre type ;
- `value` : valeur numérique.
Le corps Markdown reste libre. Les rubriques suivantes peuvent servir de repères lorsquelles sont utiles :
Le corps Markdown reste libre. Rubriques possibles :
```markdown
## Emploi
@@ -289,44 +309,34 @@ Le corps Markdown reste libre. Les rubriques suivantes peuvent servir de repère
## Sources
```
Les paradigmes, exceptions, constructions et commentaires détaillés appartiennent au corps plutôt quau front matter. Les rubriques vides ne sont pas ajoutées.
### Signes
## Fiches de signes
La commande suivante :
Commande :
```sh
./scripts/new-content.py signes 113 --title BE
```
produit :
Champs propres :
```toml
+++
title = "BE"
date = 2026-08-05T12:30:00+02:00
# updated = YYYY-MM-DDTHH:MM:SS+HH:MM
description = ""
draft = true
[extra]
sign = ""
mzl = "113"
[taxonomies]
lectures = []
+++
```
- le fichier est nommé `mzl-113.md` ;
- `title` contient le nom usuel du signe ;
- `sign` contient le caractère cunéiforme Unicode ;
- `mzl` reprend exactement les trois chiffres du nom de fichier ;
- `mzl` contient les trois chiffres du numéro ;
- `lectures` contient les lectures translittérées.
Le générateur forme automatiquement le nom `mzl-XXX.md` et renseigne le numéro MZL correspondant. Le validateur vérifie ensuite que `sign`, `mzl` et `lectures` restent présents avec le type attendu, même lorsque la fiche est en brouillon. Il nimpose pas de valeur non vide et ne compare pas le numéro au nom du fichier.
Le validateur vérifie la présence et le type de ces champs, mais ne compare pas `mzl` au nom du fichier.
Le corps peut accueillir, selon le besoin :
Rubriques possibles :
```markdown
## Valeurs syllabiques
@@ -336,43 +346,27 @@ Le corps peut accueillir, selon le besoin :
## Notes
```
Une fiche de signe peut rester sans corps si son front matter suffit.
Le corps peut rester vide lorsque le front matter suffit.
## Notes de grammaire
### Grammaire
```toml
+++
title = "Titre de la fiche"
date = 2026-08-05T12:30:00+02:00
# updated = YYYY-MM-DDTHH:MM:SS+HH:MM
description = ""
draft = true
[taxonomies]
themes = []
+++
```
`themes` regroupe les fiches par notion grammaticale. Le corps est organisé librement selon le sujet.
## Textes étudiés
### Textes
```toml
+++
title = "Titre du texte"
date = 2026-08-05T12:30:00+02:00
# updated = YYYY-MM-DDTHH:MM:SS+HH:MM
description = ""
draft = true
[taxonomies]
genres = []
+++
```
`genres` décrit le type documentaire, par exemple `lettre` ou `inscription commémorative`.
`genres` décrit le type documentaire, par exemple `lettre` ou `inscription-commémorative`.
Une structure fréquente est :
Structure possible :
```markdown
## Présentation
@@ -383,35 +377,27 @@ Une structure fréquente est :
## Vocabulaire
```
Elle peut être adaptée à chaque texte.
## Articles
### Articles
```toml
+++
title = "Titre de larticle"
date = 2026-08-05T12:30:00+02:00
# updated = YYYY-MM-DDTHH:MM:SS+HH:MM
description = ""
draft = true
[extra]
banner = ""
banner_alt = ""
banner_credit = ""
+++
```
- `description` est affichée dans la liste des articles, sur la page daccueil et dans la page elle-même ;
- `banner` indique un chemin relatif à `src/static/`, par exemple `images/articles/article.webp` ;
- `banner_alt` contient le texte alternatif de limage ;
- `description` est affichée dans la liste des articles, sur laccueil et dans la page ;
- `banner` est un chemin relatif à `src/static/`, par exemple `images/articles/article.webp` ;
- `banner_alt` contient le texte alternatif ;
- `banner_credit` contient une attribution ou une légende facultative.
Lorsque `banner` reste vide, aucune image ni aucun espace réservé ne sont générés. Lorsquune image est ajoutée, son texte alternatif doit décrire utilement son contenu ; une image purement décorative peut utiliser une chaîne vide.
Lorsque `banner` est vide, aucune image nest générée. Lorsquil est renseigné, le template lit les dimensions du fichier avec Zola et les ajoute au HTML. Une image informative doit avoir un texte alternatif utile ; une image purement décorative peut utiliser une chaîne vide.
## Liens internes
## Markdown et ressources
Les liens entre contenus utilisent les chemins internes de Zola :
### Liens internes
Les liens vers dautres contenus utilisent la syntaxe interne de Zola :
```markdown
[Voir bītum](@/vocabulaire/bītum.md)
@@ -420,45 +406,67 @@ Les liens entre contenus utilisent les chemins internes de Zola :
Ils sont ajoutés lorsquils apportent un contexte réel : occurrence dans un texte, exemple grammatical, signe observé ou relation lexicale utile.
### Blocs de code
Un bloc délimité par trois accents graves et associé à une langue reçoit automatiquement la coloration syntaxique :
````markdown
```python
print("šulmu")
```
````
Zola génère `giallo.css`, tandis que le HTML rendu utilise les classes correspondantes. Cette feuille est produite pendant la construction et ne doit pas être modifiée ou ajoutée aux sources.
## Ce que contrôle le validateur
Le validateur est volontairement limité à la structure des fiches placées dans `articles/`, `grammaire/`, `signes/`, `textes/` et `vocabulaire/`. Les pages situées directement dans `src/content/`, comme la bibliographie et les mentions légales, ainsi que les fichiers `_index.md`, sont entièrement ignorés.
`check-content.py` contrôle uniquement les fiches des cinq sections. Il ignore les fichiers `_index.md` et les pages placées directement dans `src/content/`.
Pour chaque fiche, il vérifie que le fichier peut être lu en UTF-8, que son front matter TOML est valide et quil contient exactement une ligne `updated`, commentée ou active. Il contrôle ensuite la présence et le type des champs communs :
Pour chaque fiche, il vérifie :
- `title` et `description` doivent être des chaînes, éventuellement vides ;
- `date` doit être un horodatage TOML ;
- `draft` doit être un booléen ;
- `updated`, lorsquil est actif, doit également être un horodatage TOML.
- la lecture en UTF-8 ;
- la présence dun front matter délimité par `+++` ;
- la validité du TOML ;
- exactement une ligne `updated`, commentée ou active ;
- `title` et `description` de type chaîne ;
- `date` de type horodatage TOML ;
- `draft` de type booléen ;
- `updated`, lorsquil est actif, de type horodatage TOML.
Les brouillons et les fiches publiées sont contrôlés de la même façon. Le validateur n’évalue pas la qualité éditoriale des valeurs et nexige donc ni titre, ni sens, ni thème verbal non vide. La nature grammaticale unique et connue sert seulement à déterminer le modèle lexical applicable.
Pour le vocabulaire, il vérifie également :
Pour le vocabulaire, il vérifie en plus :
- la présence dune seule nature grammaticale connue dans `taxonomies.natures` ;
- la présence de tous les champs `[extra]` prévus pour cette nature ;
- exactement une nature grammaticale reconnue ;
- tous les champs `[extra]` prévus pour cette nature ;
- des chaînes pour les champs simples ;
- un tableau de chaînes pour `logograms`, qui peut être vide.
- un tableau de chaînes pour `logograms`.
Pour les autres sections, il vérifie les modèles centralisés dans `_schema.py` :
Pour les autres sections, il vérifie :
- `banner`, `banner_alt` et `banner_credit` pour les articles ;
- `themes` pour la grammaire ;
- `sign`, `mzl` et `lectures` pour les signes ;
- `genres` pour les textes.
Les tableaux peuvent être vides et les chaînes peuvent être vides. Les champs supplémentaires ne sont pas rejetés. Le validateur ne contrôle ni la forme des noms de fichiers, ni la correspondance du numéro MZL avec le fichier, ni la normalisation Unicode du chemin ou du contenu.
Dans `themes` et `genres`, les espaces sont refusés : un terme composé doit utiliser des tirets.
Zola reste responsable de la construction, des liens internes, des taxonomies et du rendu des templates. Le générateur reste responsable de produire les noms de fichiers attendus et des squelettes complets.
Le validateur accepte les chaînes et tableaux vides. Il ne contrôle pas :
## Principes de cohérence
- la qualité ou lexactitude linguistique des valeurs ;
- les champs supplémentaires ;
- la forme des noms de fichiers ;
- la correspondance entre le numéro MZL et le nom du fichier ;
- la normalisation Unicode des fichiers existants.
- conserver tous les champs prévus par le modèle, même vides ;
- conserver exactement une ligne `updated`, commentée ou active ;
- ne renseigner que des informations établies ou utiles ;
- garder une graphie stable pour chaque lemme, lecture et terme de taxonomie ;
- employer `draft = true` pour un contenu incomplet ou temporairement hors ligne ;
- exécuter `update-content.py` uniquement après une modification substantielle ;
- éviter de répéter dans le corps une donnée déjà claire dans le front matter, sauf lorsquune explication apporte quelque chose ;
- rédiger des descriptions courtes et informatives lorsquun résumé spécifique est utile ;
- ne pas ajouter de rubriques vides ni de textes dattente.
Zola reste responsable des liens, taxonomies et templates. Le générateur reste responsable de produire des noms de fichiers valides et des squelettes complets.
## Vérification avant publication
Avant de publier ou déployer :
- conserver tous les champs du modèle, même vides ;
- conserver exactement une ligne `updated` ;
- utiliser `draft = false` uniquement pour un contenu prêt ;
- utiliser des tirets dans les thèmes et genres composés ;
- éviter les rubriques vides et les textes dattente ;
- lancer `update-content.py` seulement après une modification substantielle ;
- exécuter le validateur, `zola check`, la construction avec brouillons, puis la construction publique.