Migrer de latest vers la bêta
Un projet sur la version courante — la 0.4 — se génère avec la bêta 0.5 tel quel : tous les champs que la 0.5 ajoute sont facultatifs.
Mettre à jour
npm install docpensieve@beta
Par npx seul, npx docpensieve@beta lance la bêta. Le retour en arrière est
npm install docpensieve@latest.
Relisez votre site une fois après la mise à jour — c'est le contrôle le moins cher qui soit :
npx docpensieve build
npx docpensieve check
Ce qui change tout seul
devetserven'écoutent plus que cette machine. Ils écoutaient toutes les interfaces : quiconque était sur le même réseau pouvait lire le site en cours d'écriture. Pour le regarder depuis un téléphone sur le même wifi, dites-le :npx docpensieve dev --host 0.0.0.0.- Les blocs de code ont leur propre fond. Un bloc dans un langage que le coloriseur ignore restait sur le fond nu de la page ; il ressemble désormais à tous les autres.
- Une erreur garde son indice. Une erreur levée par l'outil pendant la compilation d'une page ne ressort plus en plainte de syntaxe générique.
- Un réglage qui ne faisait rien arrête désormais la génération.
copyCode: 'yes'éteignait le bouton en silence, et unTimeTimeravec unstartsansdurationcachait son contenu ; les deux nomment maintenant ce qui ne va pas. Générez une fois après la mise à jour : c'est là que ça se voit. ScrollToTop,Menuet le bouton clair / sombre parlent la langue de la page quand vous ne leur donnez pas de libellé. Un projet qui écrit ses propres mots dansuien a deux de plus à écrire :switchToLightetswitchToDark.- Un lecteur garde sa langue d'une version à l'autre. Le sélecteur de version, le bandeau d'une bêta et les liens de l'en-tête menaient un lecteur français aux pages anglaises ; ils mènent désormais aux pages françaises partout où elles existent.
Ce qu'il vaut la peine d'activer
- Snippet, pour montrer un vrai fichier plutôt qu'une copie.
- Hero et Calendar.
copyCode, un bouton de copie sur chaque bloc de code — éteint par défaut, puisque c'est ce qui fait charger un script à une page. Voir la référence.snippetIcons, si votre projet installe un jeu d'icônes.llms, pourllms.txtet une copie Markdown de chaque page.
Ce qu'il faut vérifier ensuite
- Votre propre CSS, si le dossier de thème habille ce que la bêta touche.
npx docpensieve check, qui relit le site produit et signale les liens morts et le balisage invalide.
DocPensieve