diff --git a/AGENTS.md b/AGENTS.md index 14c54c3d..e4a9b2c2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -36,6 +36,7 @@ Il s'agit d'un site statique généré avec Hugo, dont la version peut être vé - Le code doit être écrit en anglais mais documenté en français, lisible par un humain - Documenter clairement toutes les fonctions et méthodes - Choisir des noms de variables appropriées et compréhensibles, tout en restant courts + - Ne JAMAIS utiliser d'opérateurs ternaires - La gestion des erreurs est considérée comme dangereuse - On ne doit jamais utiliser de fallbacks - On ne doit jamais utiliser de structures de type `try/catch` @@ -157,10 +158,13 @@ Il s'agit d'un site statique généré avec Hugo, dont la version peut être vé - `title` : Titre que je donne à mon article - `date` : Si possible avec l'heure, mais la majorité de mes articles actuels ne contiennent que la date - Le frontmatter peut contenir d'autres attributs optionnels, autres que les taxonomies : + - `cover` : Chemin vers l'image illustrant l'article. Cette image doit être stockée dans le dossier `{chemin du bundle}/images/`. Elle sera utilisée pour générer la vignette de l'article, et affichée en en-tête de l'article. Je la désigne par _cover_, _image de couverture_, ou _image d'en-tête_ - `dossier` : Plusieurs bundles partageant une même valeur pour l'attribut `dossier` seront regroupés dans un _dossier virtuel_ tout en résidant physiquement dans leurs dossiers _physiques_ respectifs + - Exemple : `dossier: [ "Exploitation de mes données météo" ]` - Cet attribut devrait être complété par un attribut `weight` + - Par exemple : ```json @@ -179,6 +183,7 @@ Il s'agit d'un site statique généré avec Hugo, dont la version peut être vé - Les attributs `name` (titre du document) et `url` sont requis - L'attribut `lang` ne doit être renseigné **que** si l'on connait avec certitude la langue du document distant + - Le frontmatter doit être séparé du corps de l'article par une ligne vide ### Markdown