Skip to main content

Sidebar Mapping: Edit sidebars.js Only

For normal sidebar ordering and folder mapping, update only sidebars.js.

What to edit​

  • File: /opt/docker-data/apps/docusaurus/site/sidebars.js
  • Update category order, labels, and dirName mappings.
  • Use type: 'autogenerated' for folder-based sections.

Example pattern​

{
  type: 'category',
  label: '3. User Group Management',
  items: [
    {
      type: 'category',
      label: 'Intro',
      items: [{ type: 'autogenerated', dirName: 'server/linux-server/03. User-Group-Management/Intro' }],
    },
  ],
}

When docusaurus.config.js is not required​

You do not need to edit docusaurus.config.js when:

  • Reordering existing sidebar categories
  • Renaming sidebar category labels
  • Changing autogenerated folder targets in the same sidebar ID

When docusaurus.config.js is required​

Edit docusaurus.config.js only if you need to:

  • Change sidebarId used by navbar/doc links
  • Add a new docs plugin instance
  • Change docs plugin behavior

Quick checklist​

  • Edit sidebars.js
  • Keep dirName paths correct
  • Keep sidebar IDs unchanged unless you also update config references