VitePress Sidebar
Um plugin do VitePress que monta a barra lateral a partir dos arquivos em disco. Ordenação, títulos, filtros e ajustes por pasta substituem um menu mantido à mão.
Sobre este projeto
O VitePress Sidebar constrói a barra lateral de um site VitePress a partir da árvore de pastas, para que um site de documentação deixe de carregar um menu escrito à mão que tem de ser editado sempre que uma página é acrescentada, mudada de nome ou movida. Envolve a configuração do VitePress com uma chamada de função e deixa tudo o resto no sítio.
O menu gerado é ajustável e não fixo. Os títulos podem vir do cabeçalho do ficheiro ou do frontmatter; as pastas podem ser ordenadas, recolhidas até uma profundidade escolhida, filtradas, renomeadas ou excluídas, e uma pasta pode ter um ficheiro de configuração próprio quando precisa de diferir das restantes. As barras laterais múltiplas e as substituições por frontmatter funcionam tal como o VitePress as documenta, pelo que nada do que o tema predefinido já faz é retirado.
Está escrito em TypeScript, traz as suas próprias declarações, acrescenta pouco à compilação e nada à página, e acompanha a versão atual do VitePress. Cada opção está documentada com um exemplo.
Funcionalidades
Site de documentação
Tipos de TypeScript
Vários idiomas
Verificado por testes