BHDicaire

Catégories générées

Règles de gouvernance Détails d’implémentation

Les pages de catégories sont générées depuis tokens/core.tokens.json au moyen d’un fichier de données Hugo dérivé. Les tableaux de jetons manuels ne sont pas permis, parce qu’ils dérivent dès qu’une valeur change.

Cette règle suit le motif des pages pilotées par les données : les données structurées possèdent les faits, Hugo possède le rendu, et la validation échoue lorsqu’une métadonnée requise manque.

La chaîne de jetons produit maintenant deux sorties : assets/css/generated/tokens.css pour les variables CSS utilisées à l’exécution et data/brand/tokens.yml pour les tableaux de documentation. Hugo regroupe le CSS dans la feuille de style du site et rend le fichier de données avec le shortcode token-table.

Pages de catégories actuelles#

Ces pages sont générées depuis les données des jetons :

Ajoutez d’autres pages de catégories seulement lorsque le groupe de jetons source existe et contient ses métadonnées :

  • Mouvement
  • Rayon
  • Ombre
  • Taille d’icônes

Contrat de source#

Chaque jeton rendu par une page de catégorie doit avoir :

  • un chemin de jeton stable
  • un nom de propriété personnalisée CSS généré depuis ce chemin
  • une valeur
  • un type
  • une courte description ou un cas d’usage
  • une catégorie ou un groupe
  • un ordre de tri prévisible
  • un genre : primitif, d’échelle, sémantique ou propre à un composant

Le générateur doit :

  • lire tokens/core.tokens.json comme source de vérité
  • échouer lorsqu’une métadonnée requise manque
  • générer des données réutilisables consommées par Hugo
  • inclure le chemin source, le nom CSS généré, la valeur, le type et le cas d’usage
  • éviter d’écrire des pages générées à la main
  • s’exécuter dans une commande de vérification normale sans avertissement

La vérification actuelle est npm run tokens:check : elle prouve que la sortie CSS est à jour, que les données Hugo générées sont à jour, que chaque jeton source a les métadonnées requises et que le CSS du site ne dépend pas d’un jeton généré manquant.

Journal des changements

Vérification la plus récente de toutes les entrées : août 17, 2026

    • Génération des données de référence des jetons et des pages de catégories depuis les métadonnées des jetons, avec npm run tokens:check pour détecter la dérive des données.
    • Acceptation de l’ADR 0005 : la documentation des catégories de jetons doit être générée depuis les métadonnées des jetons ou la sortie de Style Dictionary, et non maintenue dans des tableaux manuels.
    • Déploiement de Fondations > Jetons en petite section avec Introduction, Types de jetons, Nommage, Chaîne et Catégories générées.
    • Activation du CSS de jetons généré dans le bundle de feuilles de style Hugo et ajout de npm run tokens:check pour protéger la sortie générée et les références CSS.
    • Ajout de npm run tokens:update comme workflow sûr pour les jetons : regénérer le CSS, puis le vérifier.
    • Ajout de la chaîne Style Dictionary dormante : jetons sources, sortie CSS générée et npm run tokens:build.