VitePress Sidebar
Плагин VitePress, который строит боковое меню по файлам на диске. Порядок, заголовки, фильтры и настройки для каждой папки заменяют меню, которое велось вручную.
Об этом проекте
VitePress Sidebar строит боковое меню сайта на VitePress по дереву папок, чтобы сайт документации перестал носить с собой написанное вручную меню, которое приходится править при каждом добавлении, переименовании или переносе страницы. Он оборачивает конфигурацию VitePress одним вызовом функции и оставляет всё остальное на месте.
Получающееся меню настраивается, а не задано намертво. Заголовки можно брать из заголовка файла или из frontmatter; папки можно сортировать, сворачивать до выбранной глубины, отфильтровывать, переименовывать или исключать, а папка, которой нужно отличаться от прочих, может нести собственный файл настроек. Несколько боковых меню и переопределения через frontmatter работают так, как это описано в документации VitePress, поэтому ничего из того, что тема по умолчанию уже умеет, не отнимается.
Он написан на TypeScript, несёт собственные объявления, добавляет немного к сборке и совсем ничего к странице и следует нынешнему выпуску VitePress. Каждый параметр описан с примером.
Возможности
Сайт документации
Типы TypeScript
Несколько языков
Проверено тестами