使用 vuepress 快速搭建文档
搭建
侧边栏使用
- 官方文档侧边栏使用
- 想为不同的页面组来显示不同的侧边栏,如图所示:
- 需要在config.js中配置侧边栏导航,目录结构如下:
// 侧边栏配置
sidebar: {
'/company/': [{
title: '企业端',
collapsable: false,
children: ['login', 'companyInfo', 'jisuanqi']
}],
'/policy/': [{
title: '管理端',
collapsable: false,
children: ['login',
'company',
'publicity',
'activity',
'special',
'message'
],
}],
// fallback
'/': [
'',
]
}
项目部署出现样式丢失,图片加载失败的问题
-
资源加载失败,基本都是路径出了问题。这里的根目录 / 路径是我们之前在
/docs/.vuepress/config.js
中配置的base
字段。 -
例如:配置
base:'/doc/',
打包到dist之后,上传到服务器,在服务器中新建文件夹doc
,存入打包内容即可。
打包
执行:npm dev docs:build
已有vuepress项目运行
- 将 VuePress 安装为本地依赖 npm install -D vuepress
- npm run docs:dev