Déposer une page

Les trois gestes

1. Poser le document dans la racine publiée

La racine de publication est libria-release/libria.pages.dev/. Une page simple se place sous libria.pages.dev/pages/ma-page.html. Un outil qui possède ses propres données, scripts ou médias se place dans un dossier portant son nom, avec un index.html :

libria.pages.dev/pages/ma-page.html               → /pages/ma-page.html
libria.pages.dev/pages/mon-outil/index.html       → /pages/mon-outil/
libria.pages.dev/pages/mon-outil/catalog.json     (ressource de l’outil)

Nommer les fichiers en minuscules, avec des tirets, sans espace ni accent. Les notes, sauvegardes, scripts et rapports restent hors de libria.pages.dev/, dans les dossiers frères backups/, tools/ ou audit/.

2. Déclarer l’entrée dans les deux annuaires

Le site possède deux surfaces synchronisées : libria.pages.dev/index.html pour les personnes et libria.pages.dev/index.json pour les agents. Ajouter la même destination dans les deux, avec un titre et une description cohérents. La carte humaine peut pointer vers pages/mon-outil/index.html ; le catalogue machine peut employer la forme canonique pages/mon-outil/.

La page elle-même doit contenir un <title> et une <meta name="description"> justes. Ces balises décrivent le document et améliorent sa découverte, mais elles ne réécrivent pas automatiquement les annuaires.

3. Contrôler avant le déploiement

Depuis libria-release/, lancer :

python3 tools/audit_site_structure.py

Le contrôle vérifie les liens locaux, compare les cartes de l’accueil au manifeste index.json, inventorie les documents HTML et écrit son rapport hors de la racine déployée, dans audit/site-structure-report.json. Il retourne un échec si un lien ou une entrée diverge.

Ce qu’une session ne touche pas sans mandat explicite

Élément	Règle
Les pages des autres sessions	Ajouter sa propre page ; ne pas réécrire celle d’une autre session sans demande explicite.
`index.html` et `index.json`	Les mettre à jour ensemble lorsqu’une entrée est ajoutée, déplacée ou retirée, puis lancer l’audit.
`style.css`	Feuille commune : ajouter des règles compatibles plutôt que supprimer des sélecteurs utilisés par des pages existantes.
`archives/`	Ne jamais remplacer un instantané historique ou son manifeste ; créer une nouvelle archive datée si nécessaire.
`backups/`, `tools/`, `audit/`	Zones de travail hors racine publique ; elles ne font pas partie du déploiement Pages.

Deux pièges qui n’apparaissent qu’en ligne

Les chemins absolus

Un chemin absolu de disque ou file:///… peut sembler fonctionner localement, puis échouer une fois publié. Employer uniquement des chemins relatifs depuis la page concernée.

La casse des noms

La casse est significative sur le serveur : Donnees.json et donnees.json sont deux noms différents. Employer le nom exact déclaré dans le fichier.

Le site est public

Tout fichier placé sous libria.pages.dev/ est destiné à la lecture publique. Les secrets, clés de service, sauvegardes non destinées à la publication et documents de travail restent hors de cette racine.