新建文档

WARNING

菜单具体链接路由必须以 / 开头和结尾

新建目录

docs/theme/configs/nav 中的 navbar.jssidebar.js 分别创建目录

属性名描述
text中文名称
link具体链接路由

一级菜单

navbar.jsnavbar 数组中添加,举个 🌰

点击查看
export const navbar = [
  {
    text: '指南',
    link: '/guide/'
  }

sidebar.jssidebar 对象中添加,举个 🌰

点击查看
export const sidebar = {
  '/guide/'
}

keynavbar 数组中声明的 link的值

子菜单

navbar.jsnavbar 数组中找到对应的父级菜单,在 children 中添加如一级菜单中的对象,举个 🌰

点击查看
export const navbar = [
  {
    text: '指南',
    children: [
      {
        text: '介绍',
        link: '/guide/introduction/',
      },
    ],
  },
]

sidebar.jssidebar 对象中找到对应的父级菜单,有两种方式

方法一

在其 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 文件中写了 Frontmatteropen in new window 则使用 Frontmatter 中的 title ,举个 🌰

docs/doc-document/catalogue/README.md

点击查看
---
title: 目录结构
date: 2022-11-10
permalink: /doc-document/catalogue/
---

# 目录结构

如何展示 demo

已经封装了 md 的命令 在 theme/configs/pluginsopen in new window 中的 mdPlugin

举个 🌰

点击查看
:::demo
label/basic
:::(这里:替换为:,文档中写三个:会有问题)

其中 :::demo 是已经封装的语法,label/basic 是文件夹 theme/examples 中对应的文件路径

上次更新:
贡献者: zml