@fraza/core 0.3.8 → 0.3.12

package/dist/docs/06-modules/pages/index.md

@@ -4,28 +4,40 @@ description: Pages CMS hiérarchiques rendues à la racine du site, éditées au
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/pages/installation
-    - 06-modules/pages/configuration
+    - 06-modules/pages/01-installation
+    - 06-modules/pages/02-configuration
 ---
 
 `@fraza/module-pages` ajoute une section « Pages » à l'admin et rend chaque page publiée à la racine du site, à l'URL construite depuis sa chaîne de parents. Le contenu est édité au `BlockEditor` du core et rendu par un template fourni par le projet hôte.
 
+```bash
+npm i @fraza/module-pages
+```
+
+| Paquet | `@fraza/module-pages` |
+|---|---|
+| Licence | MIT, Fraza Libre. |
+| Registre | npmjs, sans compte ni configuration. |
+| Activation | `FRAZA_MODULE_PAGES=true` |
+
+L'activation, la création de la table et le rendu public sont dans [Installation](./01-installation.md).
+
 Le module est indépendant de `@fraza/module-posts`. Les deux peuvent cohabiter : pages sert de repli sur toute URL non réclamée, posts réserve son préfixe.
 
 ![La liste des pages dans l'admin, rangée en arbre](../../assets/modules/pages/liste.light.webp)
 
-La liste range chaque page sous son parent, décalée d'un cran par niveau, et affiche sous le titre le chemin public reconstruit depuis la chaîne des parents. La colonne SEO n'apparaît que si `FRAZA_SEO` est actif. Le détail de l'écran est dans [Administration](./admin.md).
+La liste range chaque page sous son parent, décalée d'un cran par niveau, et affiche sous le titre le chemin public reconstruit depuis la chaîne des parents. La colonne SEO n'apparaît que si `FRAZA_SEO` est actif. Le détail de l'écran est dans [Administration](./03-admin.md).
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer la table, brancher le rendu public. |
-| [Configuration](./configuration.md) | Variables d'environnement, permissions, entrée d'admin. |
-| [Administration](./admin.md) | Liste arborescente, formulaire, parent, dates et enregistrement. |
-| [Modèle de données](./modele-de-donnees.md) | Table `fraza_pages_page`, hiérarchie, règles de slug et de visibilité. |
-| [Templates](./templates.md) | Écrire un template de page et les propriétés qu'il reçoit. |
-| [API](./api.md) | Routes HTTP et fonctions serveur importables. |
+| [Installation](./01-installation.md) | Installer le module, créer la table, brancher le rendu public. |
+| [Configuration](./02-configuration.md) | Variables d'environnement, permissions, entrée d'admin. |
+| [Administration](./03-admin.md) | Liste arborescente, formulaire, parent, dates et enregistrement. |
+| [Modèle de données](./04-modele-de-donnees.md) | Table `fraza_pages_page`, hiérarchie, règles de slug et de visibilité. |
+| [Templates](./05-templates.md) | Écrire un template de page et les propriétés qu'il reçoit. |
+| [API](./06-api.md) | Routes HTTP et fonctions serveur importables. |
 
 ## Ce que le module apporte
 

package/dist/docs/06-modules/posts/{installation.md → 01-installation.md}

@@ -4,16 +4,16 @@ description: Installer @fraza/module-posts, déclarer un premier type, créer le
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/types-et-champs
-    - 06-modules/posts/configuration
+    - 06-modules/posts/03-types-et-champs
+    - 06-modules/posts/02-configuration
 ---
 
-Cette page couvre l'installation de `@fraza/module-posts` dans un projet déjà structuré par `@fraza/start`. Le module n'est jamais déclaré à la main : il est découvert au boot par scan des dépendances, comme décrit dans [Cycle de vie d'un module](../../02-guides/cycle-de-vie-d-un-module.md).
+Cette page installe `@fraza/module-posts` dans un projet créé par `npx @fraza/start`. Le module n'est jamais déclaré à la main : il est découvert au boot par scan des dépendances, comme décrit dans [Cycle de vie d'un module](../../02-guides/cycle-de-vie-d-un-module.md).
 
 ## Prérequis
 
-- Un projet généré par `npx @fraza/start`, avec `@fraza/core` installé.
-- Aucune configuration ni connexion : le module est gratuit et publié sur npmjs.
+- Un projet créé par `npx @fraza/start`, avec `@fraza/core` à jour.
+- Aucun compte : le paquet est publié sur npmjs.
 
 ## Installer
 
@@ -21,33 +21,29 @@ Cette page couvre l'installation de `@fraza/module-posts` dans un projet déjà
 npm i @fraza/module-posts
 ```
 
-## Déclarer un premier type
+Ajouter la variable d'activation et un premier type à `.env.local`, et aux variables de la plateforme en production :
 
-Contrairement aux autres modules, activer `@fraza/module-posts` ne suffit pas : sans type déclaré, il ne crée aucune section d'admin et ne rend rien.
-
-```bash
+```dotenv
 #------ MODULE - POSTS ------#
 FRAZA_MODULE_POSTS=true
 FRAZA_MODULE_POSTS_TYPES=blogue:Blogue:MoonIcon
 FRAZA_MODULE_POSTS_TYPE_BLOGUE=title:title|slug:slug|date:date:now:sidebar|content:editor:Contenu
 ```
 
-Trois lignes, dans cet ordre : le drapeau d'activation, la liste des types, puis les champs de chaque type. Le nom de la variable de champs est dérivé de la clé du type en majuscules.
+Sans le drapeau, le module est ignoré : aucune table, aucune route, aucune entrée d'admin. Contrairement aux autres modules, le drapeau seul ne suffit pas : sans type déclaré, le module ne crée aucune section d'admin et ne rend rien.
 
-La syntaxe complète est dans [Types et champs](./types-et-champs.md).
+Les trois lignes viennent dans cet ordre : le drapeau d'activation, la liste des types, puis les champs de chaque type. Le nom de la variable de champs est dérivé de la clé du type en majuscules. La syntaxe complète est dans [Types et champs](./03-types-et-champs.md).
 
-## Créer les tables
+Régénérer les manifestes, puis créer les tables :
 
 ```bash
 npx fraza-modules sync    # déclenché automatiquement au postinstall
 npx fraza-db init         # crée les tables du module
 ```
 
-`fraza-db init` est **sensible à la configuration** pour ce module. Il ne crée les tables de taxonomies que si au moins un type déclare un champ `taxonomy`, et la table des relations que si au moins un type déclare un champ `relation`.
-
-Conséquence directe : après avoir ajouté une taxonomie ou une relation à un type existant, il faut relancer `npx fraza-db init`. La commande est idempotente, elle ne touche pas aux données en place.
+`fraza-db init` est idempotent : sur une base qui a déjà les tables, il applique les migrations en attente sans toucher aux données. Il enregistre aussi les permissions `posts.view` et `posts.manage`, et les attribue au rôle `admin`.
 
-Voir [Modèle de données](./modele-de-donnees.md) pour le détail des tables et des migrations.
+Pour ce module, `fraza-db init` est **sensible à la configuration**. Il ne crée les tables de taxonomies que si au moins un type déclare un champ `taxonomy`, et la table des relations que si au moins un type déclare un champ `relation`. Après avoir ajouté une taxonomie ou une relation à un type existant, relancer `npx fraza-db init`. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 ## Brancher le rendu public
 
@@ -59,28 +55,17 @@ app/(public)/[...slug]/page.js
 
 Ce fichier itère les résolveurs de [`core/public-content`](../../03-reference/01-cores/public-content.md). Le module y enregistre le sien au boot, à la priorité 10. **Il n'y a donc rien à importer** : l'installation suffit.
 
-Le sous-chemin `@fraza/module-posts/public` exporte bien une vue par défaut, `PostPublicView({ postType, slug })`, mais elle sert de repli de débogage pour un projet qui voudrait court-circuiter le registre. Le start template ne l'utilise pas : une URL de post porte toujours son type en premier segment, elle ne se prête donc pas à un fichier de route fixe. Voir [API](./api.md).
+Le sous-chemin `@fraza/module-posts/public` exporte bien une vue par défaut, `PostPublicView({ postType, slug })`, mais elle sert de repli de débogage pour un projet qui voudrait court-circuiter le registre. Le start template ne l'utilise pas : une URL de post porte toujours son type en premier segment, elle ne se prête donc pas à un fichier de route fixe. Voir [API](./08-api.md).
 
 ## Fournir un template
 
 Le module enregistre lui-même un template `default` par type, qui rend le titre puis les blocs bruts via `BlockListRenderer`. C'est suffisant pour vérifier l'installation, pas pour un site.
 
-Pour reprendre la main sur la mise en page, écrire un template dans `components/fraza/templates/` et le déclarer sur le type. Voir [Templates](./templates.md).
-
-## Vérifier
-
-1. La connexion à la base répond :
-   ```bash
-   npx fraza-db test
-   ```
-2. Une section `Blogue` apparaît dans la barre latérale de l'admin, avec un item `Posts`.
-3. Créer un post depuis `/admin/posts/blogue/list`, le laisser en visibilité publique, puis l'ouvrir à `/blogue/<slug>`. Voir [Administration](./admin.md).
+Pour reprendre la main sur la mise en page, écrire un template dans `components/fraza/templates/` et le déclarer sur le type. Voir [Templates](./07-templates.md).
 
-Les permissions du module sont enregistrées et attribuées au rôle `admin` pendant `fraza-db init`. Un module ajouté après coup n'a donc besoin que d'un `npx fraza-db init` pour que `posts.view` et `posts.manage` apparaissent dans `/admin/roles`.
+## Ajouter les médias
 
-## Médias
-
-Si un type déclare un champ `image`, `thumbnail` ou `gallery` sans que `@fraza/module-medias` soit installé et activé, le module journalise un avertissement au boot listant les champs concernés. Le module démarre quand même, mais le sélecteur d'image reste indisponible dans l'éditeur.
+Si un type déclare un champ `image`, `thumbnail` ou `gallery` sans que `@fraza/module-medias` soit installé et activé, le module journalise au boot un avertissement qui liste les champs concernés. Le module démarre quand même, mais le sélecteur d'image reste indisponible dans l'éditeur.
 
 Le module déclare `@fraza/module-medias` comme module optionnel, dans `manifest.optionalModules` : `npx fraza-doctor` le rappelle par une information tant qu'il manque, sans en faire un constat bloquant. Voir [Dépendances souples](../../03-reference/01-cores/modules.md#dépendances-souples).
 
@@ -90,21 +75,30 @@ npm i @fraza/module-medias
 
 Puis, dans `.env.local` :
 
-```bash
+```dotenv
 FRAZA_MODULE_MEDIAS=true
 ```
 
 Voir [Module Médias](../medias/index.md).
 
+## Vérifier
+
+1. La connexion à la base répond :
+   ```bash
+   npx fraza-db test
+   ```
+2. Une section `Blogue` apparaît dans la barre latérale de l'admin, avec un item `Posts`.
+3. Créer un post depuis `/admin/posts/blogue/list`, le laisser en visibilité publique, puis l'ouvrir à `/blogue/<slug>`. Voir [Administration](./05-admin.md).
+
 ## Mettre à jour
 
 ```bash
 npx fraza-update
 ```
 
-La commande installe la dernière version de tous les paquets Fraza du site, toutes à la fois : tous les paquets Fraza à leur dernière version fonctionnent ensemble. Mettre à jour `@fraza/module-posts` seul, par `npm i`, laisserait le core et les autres modules en arrière.
+La commande installe la dernière version de tous les paquets Fraza du site, toutes à la fois, puis enchaîne `fraza-modules sync`, `fraza-db migrate` et `fraza-doctor`. Tous les paquets Fraza à leur dernière version fonctionnent ensemble : mettre à jour `@fraza/module-posts` seul, par `npm i`, laisserait le core et les autres modules en arrière.
 
-Les notes de version sont livrées avec le package, dans `node_modules/@fraza/module-posts/CHANGELOG.md`.
+Les notes de version sont livrées avec le paquet, dans `node_modules/@fraza/module-posts/CHANGELOG.md`.
 
 ## Notes
 

package/dist/docs/06-modules/posts/{configuration.md → 02-configuration.md}

@@ -4,11 +4,11 @@ description: Variables d'environnement, permissions et intégration à l'admin d
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/types-et-champs
+    - 06-modules/posts/03-types-et-champs
     - 03-reference/06-configuration/variables-d-environnement
 ---
 
-Le module inverse la répartition habituelle : la **structure** du contenu vit dans les variables d'environnement, le **contenu** vit en base. Cette page couvre les variables globales, les permissions et l'admin. La syntaxe de déclaration des types est traitée à part, dans [Types et champs](./types-et-champs.md).
+Le module inverse la répartition habituelle : la **structure** du contenu vit dans les variables d'environnement, le **contenu** vit en base. Cette page couvre les variables globales, les permissions et l'admin. La syntaxe de déclaration des types est traitée à part, dans [Types et champs](./03-types-et-champs.md).
 
 ## Variables d'environnement
 
@@ -16,7 +16,7 @@ Le module inverse la répartition habituelle : la **structure** du contenu vit d
 |---|---|---|
 | `FRAZA_MODULE_POSTS` | oui | `true` active le module. Absente ou fausse, le module est ignoré : aucune table, aucune route, aucune entrée d'admin. |
 | `FRAZA_MODULE_POSTS_TYPES` | non | Liste des types de contenu. Absente, le module est actif mais ne déclare rien. |
-| `FRAZA_MODULE_POSTS_TYPE_<CLÉ>` | non | Champs d'un type. Voir [Types et champs](./types-et-champs.md). Une erreur de déclaration fait échouer le démarrage. |
+| `FRAZA_MODULE_POSTS_TYPE_<CLÉ>` | non | Champs d'un type. Voir [Types et champs](./03-types-et-champs.md). Une erreur de déclaration fait échouer le démarrage. |
 | `FRAZA_MODULE_POSTS_TYPE_<CLÉ>_PRIVATE` | non | Champs retirés des réponses publiques et du rendu public. Chaque nom doit désigner un champ déclaré du type. |
 | `FRAZA_MODULE_POSTS_TYPE_<CLÉ>_LIST` | non | Colonnes du tableau d'admin. |
 | `FRAZA_MODULE_POSTS_TYPE_<CLÉ>_ORDERABLE` | non | `true` active le réordonnancement manuel. |
@@ -38,7 +38,7 @@ Quand le drapeau est actif :
 - Les valeurs sont stockées sous la clé `seo` des données du post.
 - Le rendu public transforme cet objet en métadonnées Next.js avec `buildSeoMetadata`, en `ogType: 'article'`.
 - Le jeton `seo` devient utilisable comme colonne dans `_LIST`, affichant une pastille de score.
-- Les champs laissés vides retombent sur le contenu du post : la méta description est dérivée d'un champ `text` ou `editor`, l'image de partage d'un champ `thumbnail` ou `image`. Voir [Repli SEO automatique](./types-et-champs.md#repli-seo-automatique).
+- Les champs laissés vides retombent sur le contenu du post : la méta description est dérivée d'un champ `text` ou `editor`, l'image de partage d'un champ `thumbnail` ou `image`. Voir [Repli SEO automatique](./03-types-et-champs.md#repli-seo-automatique).
 
 Drapeau inactif, la page publique n'expose que son titre comme métadonnée, et aucun repli n'est calculé.
 
@@ -64,13 +64,13 @@ Le module enregistre **une section de navigation par type déclaré**, et non un
 | Propriété | Valeur |
 |---|---|
 | Titre de section | Libellé du type, ou clé capitalisée si aucun libellé n'est donné. |
-| Icône | Troisième segment de la déclaration du type, `BookIcon` par défaut. Un nom du jeu `@fraza/icons`, ou une icône exportée par `components/fraza/icons.js`. Voir [Types et champs](./types-et-champs.md#déclarer-un-type). |
+| Icône | Troisième segment de la déclaration du type, `BookIcon` par défaut. Un nom du jeu `@fraza/icons`, ou une icône exportée par `components/fraza/icons.js`. Voir [Types et champs](./03-types-et-champs.md#déclarer-un-type). |
 | Ordre | 300 pour le premier type, puis 301, 302, dans l'ordre de déclaration. |
 | Chemin de la liste | `/admin/posts/<clé>/list` |
 | Chemin d'une taxonomie | `/admin/posts/<clé>/taxonomies/<clé de taxonomie>` |
 | Permission | `posts.view` sur tous les items. |
 
-Les écrans desservis par ces entrées sont décrits dans [Administration](./admin.md).
+Les écrans desservis par ces entrées sont décrits dans [Administration](./05-admin.md).
 
 L'ordre des sections suit donc l'ordre de `FRAZA_MODULE_POSTS_TYPES`, et les types occupent une plage continue à partir de 300. Un autre module ne peut pas s'intercaler entre deux types : il se place avant en prenant un ordre inférieur à 300, ou après en prenant un ordre supérieur à la plage occupée. Voir [Étendre l'admin](../../02-guides/etendre-l-admin.md).
 

package/dist/docs/06-modules/posts/{types-et-champs.md → 03-types-et-champs.md}

@@ -4,9 +4,9 @@ description: Syntaxe de déclaration d'un type de contenu, catalogue des types d
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/taxonomies-et-relations
-    - 06-modules/posts/admin
-    - 06-modules/posts/modele-de-donnees
+    - 06-modules/posts/04-taxonomies-et-relations
+    - 06-modules/posts/05-admin
+    - 06-modules/posts/06-modele-de-donnees
 ---
 
 Un type de contenu se déclare entièrement en variables d'environnement. Le module en dérive le formulaire d'édition, le tableau d'admin, les colonnes de tri, les routes publiques et le rendu.
@@ -89,8 +89,8 @@ Déclarer le champ le rend en revanche obligatoire à la saisie : le formulaire
 
 Un type sans titre change trois choses :
 
-- le slug, s'il est déclaré, n'a plus de source à laquelle se rattacher. Il est généré sous la forme `post-<id>` et reste modifiable à la main. Voir [Modèle de données](./modele-de-donnees.md) ;
-- la liste d'admin affiche un extrait du contenu à la place du titre. Voir [Administration](./admin.md) ;
+- le slug, s'il est déclaré, n'a plus de source à laquelle se rattacher. Il est généré sous la forme `post-<id>` et reste modifiable à la main. Voir [Modèle de données](./06-modele-de-donnees.md) ;
+- la liste d'admin affiche un extrait du contenu à la place du titre. Voir [Administration](./05-admin.md) ;
 - les métadonnées publiques retombent sur le slug. Renseignez le titre SEO du post pour en donner un vrai.
 
 Combiné à l'absence de `slug`, vous obtenez un type sans titre ni URL, consommé uniquement par l'API ou par une relation depuis un autre post.
@@ -105,13 +105,13 @@ FRAZA_MODULE_POSTS_TYPE_ENCARTS=contenu:editor:Contenu
 
 C'est l'interrupteur qui distingue un type destiné au site d'un type purement interne, par exemple une liste de références utilisée uniquement par des relations.
 
-Les règles de génération et d'unicité du slug sont dans [Modèle de données](./modele-de-donnees.md).
+Les règles de génération et d'unicité du slug sont dans [Modèle de données](./06-modele-de-donnees.md).
 
 ### Le champ `created`
 
 Il expose `created_at` en écriture. La valeur soumise est refusée si elle n'est pas une date valide, et refusée si elle est dans le futur. Utile pour importer des archives ou antidater une publication.
 
-Il n'est modifiable qu'après coup : la création ignore toute valeur soumise et laisse la base poser l'horodatage courant. Le contrôle n'apparaît donc pas dans le formulaire de création, seulement dans celui d'édition. Voir [Administration](./admin.md).
+Il n'est modifiable qu'après coup : la création ignore toute valeur soumise et laisse la base poser l'horodatage courant. Le contrôle n'apparaît donc pas dans le formulaire de création, seulement dans celui d'édition. Voir [Administration](./05-admin.md).
 
 ### Les champs `image` et `thumbnail`
 
@@ -119,7 +119,7 @@ Les deux ouvrent le sélecteur du [registre média](../../03-reference/03-regist
 
 La valeur stockée est l'**identifiant** du média. À la lecture, le module l'enrichit en `{ id, filename, alt_text, caption, mime_type }`. Une référence orpheline renvoie `{ id, filename: null }` plutôt qu'une erreur.
 
-Voir [Intégrer les médias](../medias/integration.md).
+Voir [Intégrer les médias](../medias/05-integration.md).
 
 ### Le champ `gallery`
 
@@ -241,7 +241,7 @@ Chaque nom est résolu d'abord contre les champs déclarés du type, puis contre
 
 Le jeton `order` sert uniquement à choisir la position de la poignée. Sur un type réordonnable qui ne le liste pas, la poignée est ajoutée d'office en tête de tableau ; sur un type qui ne l'est pas, le jeton est écarté même s'il est listé.
 
-Variable absente ou vide, l'admin affiche tous les champs déclarés du type, à l'exception des champs `slug` et `editor`. Le détail du rendu de chaque colonne est dans [Administration](./admin.md).
+Variable absente ou vide, l'admin affiche tous les champs déclarés du type, à l'exception des champs `slug` et `editor`. Le détail du rendu de chaque colonne est dans [Administration](./05-admin.md).
 
 ## Ordre manuel
 
@@ -251,7 +251,7 @@ FRAZA_MODULE_POSTS_TYPE_EXPERTISES_ORDERABLE=true
 
 La comparaison est stricte : seule la chaîne `true` active le drapeau.
 
-Voir [Taxonomies et relations](./taxonomies-et-relations.md) pour l'effet sur le tri et sur la hiérarchie.
+Voir [Taxonomies et relations](./04-taxonomies-et-relations.md) pour l'effet sur le tri et sur la hiérarchie.
 
 ## Exemple complet
 
@@ -270,6 +270,6 @@ Ce fichier déclare deux types : un blogue plat avec deux niveaux de classement
 
 ## Notes
 
-- Le champ `template` n'est pas déclarable. Il est ajouté d'office à chaque post, vaut `default` en l'absence de choix, et sélectionne le template de rendu. Voir [Templates](./templates.md).
+- Le champ `template` n'est pas déclarable. Il est ajouté d'office à chaque post, vaut `default` en l'absence de choix, et sélectionne le template de rendu. Voir [Templates](./07-templates.md).
 - Le champ `seo` n'est pas déclarable non plus. Il est ajouté par le core quand `FRAZA_SEO` est actif. Le drapeau `seo` d'un champ déclaré est autre chose : il désigne la source du repli automatique, il ne crée pas de champ.
 - Le manifeste du module décrit les types de champs disponibles dans sa propre documentation de variable, mais cette liste y est incomplète : elle omet `link` et `parent`, tous deux valides. Le catalogue de cette page fait foi.

package/dist/docs/06-modules/posts/{taxonomies-et-relations.md → 04-taxonomies-et-relations.md}

@@ -4,8 +4,8 @@ description: Classer des posts par termes, les relier entre eux, les imbriquer e
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/modele-de-donnees
-    - 06-modules/posts/api
+    - 06-modules/posts/06-modele-de-donnees
+    - 06-modules/posts/08-api
 ---
 
 Trois mécanismes relient un post à un autre contenu : les **taxonomies** le classent par termes, les **relations** le lient à des posts d'un autre type, la **hiérarchie** l'imbrique sous un post du même type. Les trois se déclarent comme des champs, et sont stockés hors des données JSON.
@@ -32,7 +32,7 @@ Le titre est unique dans sa taxonomie : un index unique porte sur `(type de post
 
 ### Administration
 
-Chaque taxonomie obtient son propre item dans la section d'admin du type, sous le libellé donné à la déclaration et avec l'icône `LayersIcon`. La liste des termes affiche pour chacun le nombre de posts qui l'utilisent. Voir [Administration](./admin.md).
+Chaque taxonomie obtient son propre item dans la section d'admin du type, sous le libellé donné à la déclaration et avec l'icône `LayersIcon`. La liste des termes affiche pour chacun le nombre de posts qui l'utilisent. Voir [Administration](./05-admin.md).
 
 Un terme utilisé par au moins un post **ne peut pas être supprimé**. La suppression échoue en `409`, code `term_in_use`, avec « Ce terme est utilisé par N post(s). L'en retirer avant de le supprimer. ». Le désactiver via `is_active` le retire des sélecteurs et de la route publique tout en conservant les classements existants.
 
@@ -99,7 +99,7 @@ Supprimer un parent ne supprime pas ses enfants : leur `parent_id` est remis à
 
 ### Fil d'Ariane
 
-La chaîne d'ascendants est calculée une fois par rendu et passée au template sous la propriété `breadcrumb`, de la racine jusqu'au post courant inclus. Pour un type sans champ `parent`, il est tiré du post lui-même, sans requête. Voir [Templates](./templates.md).
+La chaîne d'ascendants est calculée une fois par rendu et passée au template sous la propriété `breadcrumb`, de la racine jusqu'au post courant inclus. Pour un type sans champ `parent`, il est tiré du post lui-même, sans requête. Voir [Templates](./07-templates.md).
 
 ## Ordre manuel
 
@@ -123,7 +123,7 @@ Sans `sortBy`, la route applique déjà ce tri quand le type est réordonnable.
 
 ## Notes
 
-- Les taxonomies et les relations n'existent en base que si au moins un type les déclare. Après avoir ajouté le premier champ de ce genre, relancer `npx fraza-db init`. Voir [Modèle de données](./modele-de-donnees.md).
+- Les taxonomies et les relations n'existent en base que si au moins un type les déclare. Après avoir ajouté le premier champ de ce genre, relancer `npx fraza-db init`. Voir [Modèle de données](./06-modele-de-donnees.md).
 - Une taxonomie retirée de la déclaration d'un type cesse d'apparaître dans l'admin, mais ses termes et ses classements restent en base.
 - La recherche textuelle des routes de liste ne porte que sur le champ de titre. Ni les termes de taxonomie, ni les données des autres champs ne sont interrogés.
 - Le chemin public et le fil d'Ariane sont tronqués au-delà de 64 niveaux de hiérarchie.

package/dist/docs/06-modules/posts/{admin.md → 05-admin.md}

@@ -4,14 +4,14 @@ description: Tuile du tableau de bord, écrans du module, liste paginée et arbo
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/taxonomies-et-relations
-    - 06-modules/posts/templates
-    - 06-modules/posts/api
+    - 06-modules/posts/04-taxonomies-et-relations
+    - 06-modules/posts/07-templates
+    - 06-modules/posts/08-api
 ---
 
 Le module ajoute une section d'admin par type déclaré, et en dérive l'interface d'édition. Un formulaire de post n'est donc jamais écrit à la main : il est reconstruit à chaque chargement depuis la déclaration du type. Cette page décrit ce que fait l'interface, y compris les quelques comportements qui surprennent.
 
-La structure du formulaire vient de [Types et champs](./types-et-champs.md). Ce qui suit couvre le rendu, pas la déclaration.
+La structure du formulaire vient de [Types et champs](./03-types-et-champs.md). Ce qui suit couvre le rendu, pas la déclaration.
 
 ## Écrans
 
@@ -25,7 +25,7 @@ La structure du formulaire vient de [Types et champs](./types-et-champs.md). Ce
 | `/admin/posts/<type>/taxonomies/<taxonomie>/new` | Création d'un terme. |
 | `/admin/posts/<type>/taxonomies/<taxonomie>/edit/<id>` | Édition d'un terme. |
 
-L'accès demande `posts.view` : sans elle, `/admin/posts` et ses sous-écrans répondent 404, comme une page inconnue. Créer, modifier, supprimer et réordonner demandent `posts.manage`, pour les posts comme pour les termes. Voir [Configuration](./configuration.md).
+L'accès demande `posts.view` : sans elle, `/admin/posts` et ses sous-écrans répondent 404, comme une page inconnue. Créer, modifier, supprimer et réordonner demandent `posts.manage`, pour les posts comme pour les termes. Voir [Configuration](./02-configuration.md).
 
 L'index des types n'a pas d'entrée dans la barre latérale : celle-ci pointe directement sur la liste de chaque type. Il reste atteignable à son URL, et affiche une carte par type avec son nombre de champs. Sans type déclaré, il affiche à la place un rappel de la variable à renseigner.
 
@@ -39,7 +39,7 @@ Le module pose une tuile « Contenus » sur `/admin`, à l'ordre 70, donc derri
 
 Une ligne par type déclaré, avec son icône de barre latérale, son total et un lien vers sa liste. Un type sans contenu garde sa ligne, à zéro : la liste des types est celle de la barre latérale, et un type qui disparaîtrait de la tuile le jour où on vide sa corbeille se lirait comme une panne.
 
-Le compte des privés ne s'affiche qu'au-dessus de zéro. Il compte les posts dont la visibilité vaut `private`, c'est-à-dire ceux que le rendu public refuse de servir. Il n'y a pas d'état de brouillon dans ce module : un post est public ou privé. Voir [Modèle de données](./modele-de-donnees.md).
+Le compte des privés ne s'affiche qu'au-dessus de zéro. Il compte les posts dont la visibilité vaut `private`, c'est-à-dire ceux que le rendu public refuse de servir. Il n'y a pas d'état de brouillon dans ce module : un post est public ou privé. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 Les posts d'un type retiré de `FRAZA_MODULE_POSTS_TYPES` restent en base mais ne sont comptés nulle part : sans libellé ni section de navigation, ils n'ont ni ligne où se compter ni page où mener.
 
@@ -47,7 +47,7 @@ Les posts d'un type retiré de `FRAZA_MODULE_POSTS_TYPES` restent en base mais n
 
 Les deux derniers posts touchés, tous types confondus, chacun lié à son écran d'édition. La date est celle de `updated_at`, donc de la dernière écriture, pas de la publication : un post ancien remonte en tête si on le corrige.
 
-Un post est nommé comme la liste d'admin le nomme. Pour un type sans champ `title`, c'est donc un extrait de son premier champ `editor`, sinon de son premier champ `text`, et à défaut `#<id>`. Voir [Types et champs](./types-et-champs.md).
+Un post est nommé comme la liste d'admin le nomme. Pour un type sans champ `title`, c'est donc un extrait de son premier champ `editor`, sinon de son premier champ `text`, et à défaut `#<id>`. Voir [Types et champs](./03-types-et-champs.md).
 
 Le badge **Privé** ne marque que les lignes qui le sont : une colonne de « Public » répétés n'apprendrait rien et mangerait la largeur dont le titre a besoin.
 
@@ -98,7 +98,7 @@ Le glisser-déposer demande deux conditions réunies : le type porte le drapeau
 
 Un post ne se déplace qu'**à l'intérieur de sa fratrie**. Le lâcher sur une ligne d'un autre parent est refusé avec un message, sans requête.
 
-Le déplacement est appliqué immédiatement à l'affichage, puis persisté. Si le serveur refuse, la liste est rechargée pour se resynchroniser avec la base. Voir [Taxonomies et relations](./taxonomies-et-relations.md) pour la portée de l'ordre.
+Le déplacement est appliqué immédiatement à l'affichage, puis persisté. Si le serveur refuse, la liste est rechargée pour se resynchroniser avec la base. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md) pour la portée de l'ordre.
 
 ### Actions de ligne
 
@@ -118,7 +118,7 @@ La colonne latérale est créée dès qu'un template est enregistré pour le typ
 
 Quand `FRAZA_SEO` est actif, la zone SEO du core apparaît sous la zone de contenu. Son aperçu d'URL utilise le chemin public du post, ou le chemin reconstruit depuis le slug en cours de saisie à la création.
 
-Laissées vides, la méta description et l'image de partage retombent sur le contenu du post. La zone SEO montre alors la valeur héritée en filigrane, et la compte dans son score, pour refléter ce que la page publique émettra. La pastille de la liste applique le même calcul. Voir [Repli SEO automatique](./types-et-champs.md#repli-seo-automatique).
+Laissées vides, la méta description et l'image de partage retombent sur le contenu du post. La zone SEO montre alors la valeur héritée en filigrane, et la compte dans son score, pour refléter ce que la page publique émettra. La pastille de la liste applique le même calcul. Voir [Repli SEO automatique](./03-types-et-champs.md#repli-seo-automatique).
 
 ### Titre et slug
 
@@ -126,13 +126,13 @@ Tant que le champ slug n'a pas été touché, il suit le titre à la frappe. Le
 
 Sur un type sans champ `title`, il n'y a rien à suivre : le champ slug reste vide et le serveur y pose `post-<id>` à l'enregistrement. Vous pouvez toujours saisir la valeur de votre choix.
 
-À l'édition, le slug est considéré comme touché **dès le chargement**. Renommer le titre d'un post existant ne change donc jamais son slug, ce qui reflète exactement la règle appliquée par le serveur. Voir [Modèle de données](./modele-de-donnees.md).
+À l'édition, le slug est considéré comme touché **dès le chargement**. Renommer le titre d'un post existant ne change donc jamais son slug, ce qui reflète exactement la règle appliquée par le serveur. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 Le slug saisi est renormalisé à l'enregistrement, et suffixé s'il entre en collision avec celui d'un autre post du même type.
 
 ### Sélecteur de template
 
-Le sélecteur liste les templates enregistrés pour **ce type**, jamais ceux d'un autre. Voir [Templates](./templates.md).
+Le sélecteur liste les templates enregistrés pour **ce type**, jamais ceux d'un autre. Voir [Templates](./07-templates.md).
 
 Si le post porte un template qui n'existe plus, le sélecteur se réaligne sur le premier disponible, et l'enregistrement suivant écrit cette valeur. Le rendu public, lui, ne réécrit rien : il retombe sur `default` tant que le champ n'a pas été enregistré.
 
@@ -178,7 +178,7 @@ Sans `@fraza/module-medias` installé et activé, le bouton de sélection est re
 
 Chaque taxonomie déclarée a son propre écran, atteignable depuis la barre latérale. La liste est paginée à 20 termes, triable sur le titre, les dates et le statut.
 
-Deux colonnes méritent l'attention : le **nombre de posts** qui portent le terme, et son statut actif ou inactif. Un terme utilisé par au moins un post ne peut pas être supprimé ; le désactiver est la façon de le retirer de la circulation sans perdre les classements. Voir [Taxonomies et relations](./taxonomies-et-relations.md).
+Deux colonnes méritent l'attention : le **nombre de posts** qui portent le terme, et son statut actif ou inactif. Un terme utilisé par au moins un post ne peut pas être supprimé ; le désactiver est la façon de le retirer de la circulation sans perdre les classements. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md).
 
 Un terme porte un titre, une description facultative et son drapeau d'activité. Il n'a pas de slug. Deux termes d'une même taxonomie ne portent pas le même titre : créer ou renommer un terme avec le titre d'un autre est refusé avec le message « Un terme porte déjà ce titre dans cette taxonomie. ».
 
@@ -193,7 +193,7 @@ Le seul contrôle bloquant côté navigateur est le titre, qui ne peut pas être
 ## Notes
 
 - Les deux plafonds de l'interface, 500 posts dans le sélecteur de parent et 1000 termes dans un sélecteur de taxonomie, ne sont pas réglables.
-- La recherche n'est pas exposée dans la liste d'admin, bien que la route la supporte. Passer par [l'API](./api.md) pour l'utiliser.
+- La recherche n'est pas exposée dans la liste d'admin, bien que la route la supporte. Passer par [l'API](./08-api.md) pour l'utiliser.
 - Un post privé reste éditable dans l'admin, mais son URL publique répond une page introuvable. Le bouton de lien disparaît alors de la ligne et de l'en-tête. Il n'y a pas de prévisualisation des posts privés.
 - Supprimer un post ne supprime pas ses enfants. Ils remontent à la racine du type, et leur URL publique change en conséquence.
 - Modifier une variable de déclaration demande un redémarrage du serveur : l'admin lit la configuration analysée au boot, pas le fichier d'environnement.

package/dist/docs/06-modules/posts/{modele-de-donnees.md → 06-modele-de-donnees.md}

@@ -4,7 +4,7 @@ description: Les quatre tables du module, les écritures en transaction, les mig
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/api
+    - 06-modules/posts/08-api
     - 03-reference/01-cores/database
 ---
 
@@ -52,7 +52,7 @@ Tous les autres champs déclarés y sont écrits sous leur nom, avec `null` quan
 - `template`, l'identifiant du template de rendu, `default` en l'absence de choix ;
 - `seo`, l'objet de métadonnées, forcé à un objet vide si la valeur soumise n'en est pas un.
 
-Seules les valeurs saisies sont stockées dans `seo`. La méta description et l'image de partage dérivées du contenu n'y sont jamais écrites : elles sont recalculées à chaque rendu depuis les champs du post. Voir [Repli SEO automatique](./types-et-champs.md#repli-seo-automatique).
+Seules les valeurs saisies sont stockées dans `seo`. La méta description et l'image de partage dérivées du contenu n'y sont jamais écrites : elles sont recalculées à chaque rendu depuis les champs du post. Voir [Repli SEO automatique](./03-types-et-champs.md#repli-seo-automatique).
 
 À la lecture, le module aplatit `data` au premier niveau de l'objet post tout en conservant l'objet brut sous `_data`. Un post lu porte donc `post.title` et `post._data.title`.
 
@@ -94,7 +94,7 @@ Table de liaison, plusieurs à plusieurs.
 
 Contrainte : `UNIQUE(post_id, taxonomy, term_id)`.
 
-Supprimer un post ou un terme retire les liaisons correspondantes par cascade. La suppression d'un terme encore utilisé est cependant refusée en amont, par le module. Voir [Taxonomies et relations](./taxonomies-et-relations.md).
+Supprimer un post ou un terme retire les liaisons correspondantes par cascade. La suppression d'un terme encore utilisé est cependant refusée en amont, par le module. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md).
 
 ## `fraza_posts_relation`
 

package/dist/docs/06-modules/posts/{templates.md → 07-templates.md}

@@ -4,7 +4,7 @@ description: Écrire un template de post, les propriétés qu'il reçoit, la por
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/admin
+    - 06-modules/posts/05-admin
     - 03-reference/01-cores/templates
     - 02-guides/contenu-public-et-templates
 ---
@@ -59,7 +59,7 @@ Aucun `children` n'est injecté, le template décide seul de sa structure.
 
 ### Deux clés non déclarables sur `post`
 
-`data` porte deux clés qui ne viennent d'aucune déclaration de champ, et qui sont donc aplaties comme les autres : `post.template`, l'identifiant du template retenu, et `post.seo`, l'objet de métadonnées. Voir [Modèle de données](./modele-de-donnees.md).
+`data` porte deux clés qui ne viennent d'aucune déclaration de champ, et qui sont donc aplaties comme les autres : `post.template`, l'identifiant du template retenu, et `post.seo`, l'objet de métadonnées. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 Un type hiérarchique ajoute par ailleurs `post._path`, le chemin public reconstruit depuis la chaîne des parents. Sa valeur est celle de la propriété `url` : préférer `url`, qui est présente quel que soit le type. `_path` existe surtout pour l'admin, qui s'en sert pour le lien « voir » d'une ligne de liste.
 

package/dist/docs/06-modules/posts/{api.md → 08-api.md}

@@ -4,8 +4,8 @@ description: Routes HTTP d'admin et publiques, et fonctions serveur importables
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/modele-de-donnees
-    - 06-modules/posts/admin
+    - 06-modules/posts/06-modele-de-donnees
+    - 06-modules/posts/05-admin
     - 03-reference/01-cores/api
 ---
 
@@ -69,7 +69,7 @@ Le tri par défaut dépend du type : la colonne d'ordre en ascendant si le type
 
 Renvoie le post ou `null`, y compris quand il existe mais n'est pas public, ou qu'un de ses ancêtres ne l'est pas.
 
-Ses champs `editor` sont enrichis de leurs métadonnées médias, donc directement rendables. Ses taxonomies, relations et parent sont résolus. Les relations ne gardent que les posts visibles, sans leurs champs privés. Voir [Taxonomies et relations](./taxonomies-et-relations.md).
+Ses champs `editor` sont enrichis de leurs métadonnées médias, donc directement rendables. Ses taxonomies, relations et parent sont résolus. Les relations ne gardent que les posts visibles, sans leurs champs privés. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md).
 
 Ses champs média le sont aussi : `image` et `thumbnail` portent un objet `{ id, filename, alt_text, caption, mime_type }`, `gallery` un tableau de ces objets dans l'ordre de la galerie. L'URL publique se construit à partir de `filename`, jamais stockée. Une référence dont le média a disparu apparaît comme `{ id, filename: null }`.
 

package/dist/docs/06-modules/posts/index.md

@@ -4,30 +4,42 @@ description: Types de contenu déclarés en variables d'environnement, avec taxo
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/installation
-    - 06-modules/posts/types-et-champs
+    - 06-modules/posts/01-installation
+    - 06-modules/posts/03-types-et-champs
 ---
 
 `@fraza/module-posts` ajoute des types de contenu à l'admin, sans écrire une ligne de code. Un type, ses champs, ses taxonomies et ses relations sont déclarés dans les variables d'environnement, et le module en dérive la table, l'interface d'édition, les routes et le rendu public.
 
+```bash
+npm i @fraza/module-posts
+```
+
+| Paquet | `@fraza/module-posts` |
+|---|---|
+| Licence | MIT, Fraza Libre. |
+| Registre | npmjs, sans compte ni configuration. |
+| Activation | `FRAZA_MODULE_POSTS=true` |
+
+Le module demande en plus au moins un type déclaré. Le premier type, la création des tables et le rendu public sont dans [Installation](./01-installation.md).
+
 Le module est indépendant de `@fraza/module-pages`. Les deux peuvent cohabiter : posts réserve les URL de la forme `/<type>/<slug>`, pages sert de repli sur tout le reste.
 
 ![La liste d'un type de contenu déclaré, ici une équipe, avec ses colonnes propres](../../assets/modules/posts/liste.light.webp)
 
-Rien de cet écran n'est écrit en dur. Le libellé de la section, les colonnes affichées et la poignée de réordonnancement viennent de la déclaration du type dans les variables d'environnement. Un deuxième type déclaré donne une deuxième section, avec ses propres colonnes. Voir [Types et champs](./types-et-champs.md).
+Rien de cet écran n'est écrit en dur. Le libellé de la section, les colonnes affichées et la poignée de réordonnancement viennent de la déclaration du type dans les variables d'environnement. Un deuxième type déclaré donne une deuxième section, avec ses propres colonnes. Voir [Types et champs](./03-types-et-champs.md).
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer les tables, brancher le rendu public. |
-| [Configuration](./configuration.md) | Variable d'activation, permissions, entrées d'admin. |
-| [Types et champs](./types-et-champs.md) | Déclarer un type de contenu et ses champs. |
-| [Taxonomies et relations](./taxonomies-et-relations.md) | Classer, relier et hiérarchiser des posts. |
-| [Administration](./admin.md) | Écrans d'admin, liste, formulaire, sélecteurs et termes. |
-| [Modèle de données](./modele-de-donnees.md) | Les quatre tables, les migrations, les règles de slug. |
-| [Templates](./templates.md) | Écrire un template de post et les propriétés qu'il reçoit. |
-| [API](./api.md) | Routes HTTP et fonctions serveur importables. |
+| [Installation](./01-installation.md) | Installer le module, créer les tables, brancher le rendu public. |
+| [Configuration](./02-configuration.md) | Variable d'activation, permissions, entrées d'admin. |
+| [Types et champs](./03-types-et-champs.md) | Déclarer un type de contenu et ses champs. |
+| [Taxonomies et relations](./04-taxonomies-et-relations.md) | Classer, relier et hiérarchiser des posts. |
+| [Administration](./05-admin.md) | Écrans d'admin, liste, formulaire, sélecteurs et termes. |
+| [Modèle de données](./06-modele-de-donnees.md) | Les quatre tables, les migrations, les règles de slug. |
+| [Templates](./07-templates.md) | Écrire un template de post et les propriétés qu'il reçoit. |
+| [API](./08-api.md) | Routes HTTP et fonctions serveur importables. |
 
 ## Ce que le module apporte
 
@@ -47,7 +59,7 @@ Il n'y a pas un module par type de contenu. `FRAZA_MODULE_POSTS_TYPES` déclare
 
 La conséquence pratique : ajouter un type de contenu ne demande ni installation, ni migration, ni redéploiement de schéma. Une variable d'environnement suffit, les tables étant déjà en place.
 
-Voir [Types et champs](./types-et-champs.md) pour la syntaxe.
+Voir [Types et champs](./03-types-et-champs.md) pour la syntaxe.
 
 ## Positionnement dans le rendu public
 
@@ -57,6 +69,6 @@ Une page CMS nommée `blogue` et un type de post nommé `blogue` peuvent donc co
 
 ## Notes
 
-- Un type sans champ de type `slug` n'est jamais rendu publiquement. C'est l'interrupteur qui distingue un type public d'un type purement interne. Voir [Types et champs](./types-et-champs.md).
+- Un type sans champ de type `slug` n'est jamais rendu publiquement. C'est l'interrupteur qui distingue un type public d'un type purement interne. Voir [Types et champs](./03-types-et-champs.md).
 - Le champ `version` du manifeste suit la version du paquet : [`fraza-module sync-version`](../../03-reference/05-cli/fraza-module.md#sync-version), lancé par chaque build, la recopie dans `src/version.js`, et `prepublishOnly` refuse de publier si les deux divergent.
 - Le module lit et écrit des médias par le [registre média](../../03-reference/03-registres/media-registry.md) du core. Sans `@fraza/module-medias`, les champs `image`, `thumbnail` et `gallery` restent déclarables mais le sélecteur ne s'ouvre pas, et le module émet un avertissement au boot.