跳到主要内容

07 使用侧边栏提高效率

侧边栏配置示例:

项目/sidebars.js
/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
const sidebars = {
// 项目/docs/ 生成侧边栏
// localSidebar: [{ type: 'autogenerated', dirName: '.' }],

// 项目/docs/Linux-Command/ 生成侧边栏
LinuxCommandSidebar: [{ type: 'autogenerated', dirName: 'Linux-Command' }],

// 项目/docs/Nginx-Learning/ 生成侧边栏
NginxSidebar: [{ type: 'autogenerated', dirName: 'Nginx-Learning' }],

// 项目/docs/Docusaurus/ 生成侧边栏
DocusaurusSidebar: [{ type: 'autogenerated', dirName: 'Docusaurus' }],
};

export default sidebars;
  • 定义侧边栏名字,便于在主配置中用于配置顶部导航栏
  • 类型:autogenerated 使用目录下的所有文章生成侧边栏
  • 目录:. 表示 项目/docs 目录, Linux-Command 表示 项目/docs/Linux-Command 目录

最佳实践

前期分类较少,使用 . 生成唯一的侧边栏。

image-20250223183156053

后期分类变多,注释 . ,为每个分类配置独立的侧边栏。