Skip to content

Sidebar Generation ​

Plugin support: VitePress itself expects a manual default-theme sidebar configuration. It does not natively discover Markdown files and generate the sidebar.

This site adds vitepress-sidebar around the VitePress configuration. It scans docs/en/ and docs/ja/, uses the numeric order and title frontmatter on these pages, and produces the sidebar now visible beside this page. Adding a new eligible Markdown page is therefore enough for this project's navigation at build time.

The two approaches ​

ApproachWhere navigation is declaredTradeoff
Native VitePressthemeConfig.sidebar in configExplicit labels, grouping, and links
This siteFilesystem plus vitepress-sidebarLess repetition; plugin behavior and conventions
ts
// Native VitePress: a manual example
themeConfig: {
  sidebar: [
    { text: 'Criteria', items: [{ text: 'GFM', link: '/en/criteria/gfm' }] }
  ]
}

The plugin is a convenience layer, not evidence of native auto-generation.