新建文档
WARNING
菜单具体链接路由必须以 / 开头和结尾
新建目录
在 docs/theme/configs/nav 中的 navbar.js 和 sidebar.js 分别创建目录
| 属性名 | 描述 |
|---|---|
| text | 中文名称 |
| link | 具体链接路由 |
一级菜单
在 navbar.js 中 navbar 数组中添加,举个 🌰
点击查看
export const navbar = [
{
text: '指南',
link: '/guide/'
}
在 sidebar.js 中 sidebar 对象中添加,举个 🌰
点击查看
export const sidebar = {
'/guide/'
}
key 为 navbar 数组中声明的 link的值
子菜单
在 navbar.js 中 navbar 数组中找到对应的父级菜单,在 children 中添加如一级菜单中的对象,举个 🌰
点击查看
export const navbar = [
{
text: '指南',
children: [
{
text: '介绍',
link: '/guide/introduction/',
},
],
},
]
在 sidebar.js 中 sidebar 对象中找到对应的父级菜单,有两种方式
方法一
在其 children 添加如一级菜单中的对象,举个 🌰
点击查看
export const sidebar = {
'/guide/': [
{
text: '指南',
children: [
{
text: '介绍',
link: '/guide/introduction/',
},
],
},
],
}
方法二
在其 children 中添加 navbar 数组中声明的 link的值,举个 🌰
点击查看
export const sidebar = {
'/guide/': [
{
text: '指南',
children: ['/guide/request/'],
},
],
}
此两种方法的区别为:
方法一: 中已经写了中文名和具体路由,所以中文名字将为其声明的 text,举个 🌰
docs/doc-document/introduction/README.md
点击查看
# 介绍
组件库 doc 是以 vuepress v2.0.0-beta.53 + vue3 + iview-ui-plus 生成的文档库。
方法二: 由于只写了匹配的文件路径,中文名字将匹配 navbar.js 中的 text, 如果 README.md 文件中写了 Frontmatter 则使用 Frontmatter 中的 title ,举个 🌰
docs/doc-document/catalogue/README.md
点击查看
---
title: 目录结构
date: 2022-11-10
permalink: /doc-document/catalogue/
---
# 目录结构
如何展示 demo
已经封装了 md 的命令 在 theme/configs/plugins 中的 mdPlugin
举个 🌰
点击查看
:::demo
label/basic
:::(这里:替换为:,文档中写三个:会有问题)
其中 :::demo 是已经封装的语法,label/basic 是文件夹 theme/examples 中对应的文件路径