Comment Velocity est construit

Structure

themes/velocity/
├── ssg.toml            nom du site, description, URL de base
├── content/            le texte des pages, en Markdown
└── _layouts/
    ├── base.html       coque du document, déclare le bloc `main`
    ├── header.html     partiel de navigation
    ├── footer.html     partiel de pied de page
    ├── index.html      chaque mise en page étend base
    └── styles.css      tout le système de design

Les deux fichiers que vous modifierez

ssg.toml porte le nom du site, sa description et son URL de base. Se tromper ici, c'est publier un llms.txt qui annonce « MySsgSite » et des données structurées pointant vers 127.0.0.1.

_layouts/styles.css s'ouvre sur un bloc @layer tokens qui contient chaque couleur, chaque pas typographique et chaque valeur d'espacement. Changez --accent à cet endroit et tout le thème suit.

Vérifier une modification

Lancez make check depuis la racine du dépôt. La commande analyse les blocs de jetons et confronte chaque paire déclarée à sa cible WCAG — 7:1 pour le texte, 3:1 pour les bordures et l'anneau de focus — en clair comme en sombre. Un jeton en échec fait échouer la construction ; ce n'est pas un avertissement.

Navigateurs visés

Couches de cascade, requêtes de conteneur et :focus-visible : Chrome 111+, Firefox 128+, Safari 16.4+. Les navigateurs plus anciens reçoivent un contenu lisible sans mise en forme plutôt qu'une mise en page cassée.