VitePress Sidebar
Une extension VitePress qui construit la barre latérale à partir des fichiers présents sur le disque. Le tri, les titres, les filtres et les réglages par dossier remplacent un menu tenu à la main.
À propos de ce projet
VitePress Sidebar construit la barre latérale d’un site VitePress à partir de l’arborescence des dossiers, pour qu’un site de documentation cesse de porter un menu écrit à la main qu’il faut modifier chaque fois qu’une page est ajoutée, renommée ou déplacée. Il enveloppe la configuration de VitePress d’un appel de fonction et laisse tout le reste en place.
Le menu produit se règle au lieu d’être figé. Les titres peuvent venir du titre du fichier ou du frontmatter ; les dossiers peuvent être triés, repliés à une profondeur choisie, filtrés, renommés ou exclus, et un dossier peut porter son propre fichier de configuration là où il doit différer des autres. Les barres latérales multiples et les remplacements par frontmatter fonctionnent comme VitePress les documente : rien de ce que fait déjà le thème par défaut n’est retiré.
Il est écrit en TypeScript, embarque ses propres déclarations, ajoute peu à la compilation et rien du tout à la page, et suit la version courante de VitePress. Chaque option est documentée avec un exemple.
Fonctionnalités
Site de documentation
Types TypeScript
Plusieurs langues
Vérifié par des tests