Sidebar Navigation
Learn how to configure and customize the sidebar navigation in your XD Wiki documentation.
Configuration
The sidebar is controlled by the data/en/docs/sidebar.yaml file:
- title: Getting Started
replaceFirstPageTitle: Overview
pages:
- index
- getting-started
- installation
- title: Guides
pages:
- creating-pages
- sidebar-navigation
Structure
Each section in the sidebar can have:
- title: The section heading
- replaceFirstPageTitle: Optional override for the first page title
- pages: Array of page slugs
Page Ordering
Pages appear in the sidebar in the exact order specified in the pages array. The weight field in page front matter affects list page sorting, not sidebar order.
Customization
You can customize the sidebar appearance by modifying the layouts/partials/sidebar.html template.
Best Practices
- Group related pages together
- Use clear, descriptive section titles
- Keep the navigation structure logical
- Don’t make sections too deep