侧边栏配置
概述
在本主题中，侧边栏 特指 位于页面 最左侧的内容区域，用于导航到不同的页面。
在 vuepress 的默认主题 @vuepress/theme-default 中，侧边栏是通过 sidebar 进行配置。
但在本主题中，为使其更具语义化，主题将侧边栏配置整合到了 notes 配置 中 。 通过一个 note 对应一个 sidebar 的方式，实现更加简洁，语义化的侧边栏配置。
同时，为了满足 用户不希望使用 notes 功能的需求，本主题也提供了 sidebar 的选项进行侧边栏配置。
Notes 中的侧边栏配置
notes 的功能是聚合一系列的文章，通过侧边栏来导航到 notes 中不同的文章。
你可以在 notes 目录下创建多个 note ，在每一个 note 中单独配置 sidebar:
.vuepress/config.ts
import { defineUserConfig } from 'vuepress'
import { defineNoteConfig, plumeTheme } from 'vuepress-theme-plume'
const noteA = defineNoteConfig({
dir: 'note A',
link: '/note-a/',
sidebar: [
{ text: 'one item', link: 'one' },
{ text: 'two item', link: 'two' },
]
})
export default defineUserConfig({
theme: plumeTheme({
notes: {
link: '/',
dir: 'notes',
notes: [noteA],
},
})
})主题提供了 defineNoteConfig 来帮助你配置 note , 你可以参考 这里来查看如何配置。
通用 Sidebar 配置
如果你不想使用 notes 的方式来管理系列文章，但又期望通过侧边栏来导航到不同的文章， 可以通过 sidebar 通用配置来实现。
.vuepress/config.ts
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
notes: false,
sidebar: {
'/config/': [
{ text: '侧边栏配置', link: 'sidebar-1' },
{ text: '侧边栏配置', link: 'sidebar-2' },
]
}
})
})完整侧边栏使用说明，请查看 此文档 。
