Configuration

Chaque chaîne visible de Lucid provient du front matter et non du balisage : c'est ce qui fait d'une nouvelle langue un répertoire plutôt qu'un fork.

Front matter

Aucun gabarit de Lucid ne contient de phrase en dur. Les libellés de navigation, le texte des boutons, le nom du fil d'Ariane et jusqu'au mot « Menu » sont des clés de front matter : traduire le thème n'implique jamais de modifier du HTML.

nav_install: "Installation"
label_toc: "Sur cette page"
label_prev: "Précédent"

Une page qui omet une clé l'affiche vide plutôt que de revenir à l'anglais : une traduction manquante devient visible au lieu de rester silencieusement monolingue.

Ajouter une langue

Déclarez la langue dans ssg.toml :

[i18n]
default_locale = "en"
locales = ["en", "fr", "de"]
url_prefix = "sub_path"

Ajoutez ensuite content/de/, un fichier par page. Chaque page porte une translation_key; les pages qui partagent une clé sont considérées comme des traductions l'une de l'autre, ce qui produit les alternates hreflang. La validation du dépôt échoue si une clé ne se résout pas dans chaque langue déclarée : un site à moitié traduit est une erreur de construction, pas une surprise pour le lecteur.

Jetons de couleur

La couleur est déclarée une seule fois, en propriétés personnalisées :

--ink: #0d1117;
--ink-soft: #232a35;
--accent: #08417f;
--surface: #f4f6f9;

Chaque paire étant vérifiée en intégration continue, modifier un jeton vers une valeur au contraste insuffisant fait échouer la construction. Voir Accessibilité.