Aller au contenu
DocPensieve
Menu de la documentation

Composants

Progression du module100%

Leçon 2 sur 2 — la dernière de ce module.

Une comparaison, en colonnes

Une page qui compare deux façons de travailler se lit mieux côte à côte :

Une liste écrite à la main
Périme à la première page renommée. Rien ne vous le dit.
Une grille de cartes

Construite depuis les pages à chaque génération. Elle ne peut pas périmer.

Un tableau de bord, en jauges

Là où une équipe suit l'état de sa documentation :

82%
Pages relues
95%
Exemples testés
40%
Traduites

Un avertissement qu'on ne peut pas dépasser

Certaines phrases ne doivent pas se lire comme de la prose. Une admonition les sort du texte :

Les types que ce site a ajoutés

Six types sont livrés avec l'outil ; ces deux-là sont déclarés dans la configuration de ce site même, avec une marque prise dans un jeu d'icônes :

// docpensieve.config.mjs
admonitions: {
  claude: { label: 'Claude', tone: 'info', icon: 'simple-icons:claude' },
},

La marque est posée dans la page à la génération, comme toutes les autres icônes ici : votre lecteur ne télécharge rien, et aucune requête ne part de son navigateur.

Un terme, expliqué sur place

Un lecteur qui ne sait pas ce qu'est une bêtaUne version publiée avant la version stable, pour essayer ce qui vient. l'apprend sans quitter la phrase — à la souris comme au clavier.

Vérifiez par vous-même

Combien de scripts cette page charge-t-elle ?

Aucun. Chaque composant employé ici est rendu à la génération du site.

Cette leçon emploie Columns, Card, Skill, Tooltip et Admonition.

Bravo

Vous avez terminé Bien écrire. Le site porte de vraies pages ; le module suivant lui donne votre allure et votre navigation.

Module suivant : À votre main
Couleurs, navigation, et blocs qui arrêtent un lecteur à temps.