dengjie commit :教程编写
continuous-integration/drone/push Build is passing
Details
continuous-integration/drone/push Build is passing
Details
This commit is contained in:
parent
0ce1729f6b
commit
bec66ef460
Binary file not shown.
|
After Width: | Height: | Size: 7.0 KiB |
|
|
@ -1,4 +1,125 @@
|
|||
# 首先
|
||||
# config.js配置教程
|
||||
|
||||
## 其次
|
||||
固定侧边栏,不折叠显示: collapsable: false,
|
||||
## 设置站点根路径
|
||||
- 如果访问的时候是ip+端口,那么这里就是**/**,如果访问的是ip+端口+工程名,那么这里就是 **/工程名/**
|
||||
- 这是部署到github相关的配置
|
||||
|
||||
```
|
||||
module.exports = {
|
||||
base:'/',
|
||||
}
|
||||
```
|
||||
|
||||
## 设置编译后的输出目录
|
||||
- **./ROOT**代表在工程的根目录下生成一个ROOT文件,里面是编译好的文件,可以拿ROOT直接部署。
|
||||
|
||||
```
|
||||
module.exports = {
|
||||
dest:'./ROOT',
|
||||
}
|
||||
```
|
||||
|
||||
## 本地调试的端口号,默认是8080
|
||||
|
||||
```
|
||||
module.exports = {
|
||||
port:8086,
|
||||
}
|
||||
```
|
||||
|
||||
## 代码块显示行号
|
||||
|
||||
```
|
||||
module.exports = {
|
||||
markdown: {
|
||||
lineNumbers: true // 代码块显示行号
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 页面路由地址对应写法
|
||||
|
||||
| 文件的相对路径 | 页面路由地址 |
|
||||
| :------------ | :------------ |
|
||||
| /README.md | / |
|
||||
| /guide/README.md | /guide/ |
|
||||
| /config.md | /config.html |
|
||||
|
||||
## 网页标签的图标
|
||||
- 这里的 '/' 指向 docs/.vuepress/public 文件目录 ,即 docs/.vuepress/public/logo.png
|
||||
|
||||
```
|
||||
themeConfig: {
|
||||
head: [
|
||||
['link', {rel: 'icon', href: '/logo.png'}],
|
||||
],
|
||||
}
|
||||
```
|
||||
|
||||
## 导航栏Logo
|
||||
|
||||
```
|
||||
themeConfig: {
|
||||
logo:'/logo.png',
|
||||
}
|
||||
```
|
||||
|
||||

|
||||
|
||||
## nav配置【右上角的导航条】
|
||||
|
||||
```
|
||||
themeConfig: {
|
||||
nav:
|
||||
[
|
||||
{text: "首页", link: "/"},
|
||||
{text: "指南", link: "/wiki/introduce/"},
|
||||
{text: "博客", link: "https://blog.isww.cn/"}
|
||||
],
|
||||
}
|
||||
```
|
||||
|
||||
## 侧边栏配置
|
||||
### 设置左侧导航显示的层级
|
||||
- sidebarDepth: 2
|
||||
- 一般是以单个md文件中的 # ## ### #### 这几个标题文字为锚点自动生成导航
|
||||
- 0读取1级标题
|
||||
- 1读取1级和2级标题
|
||||
- 2读取1级、2级、3级标题
|
||||
|
||||
### 设置侧边栏内容
|
||||
- 根据自己的需求来订,对应自己在docs下的文件夹名,默认首页是README.md 【/wiki/introduce/ 相当于 /wiki/introduce/README.md】效果如下图:
|
||||
- 【注】其中侧边栏除了config.js下的title外的导航栏目是根据该目录(例如:/wiki/introduce/)下的一级、二级、三级和四级标题所自动生成的导航栏目,所以**侧边栏只需要在config.js配置页面路由地址及title即可**
|
||||
|
||||
```
|
||||
themeConfig: {
|
||||
sidebar: [
|
||||
{
|
||||
title: '文档',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/wiki/introduce/',
|
||||
'/wiki/back-build/',
|
||||
{
|
||||
title: "侧边栏组合",
|
||||
collapsable: false,
|
||||
children: [
|
||||
"/second/child/"
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 底部设置最后更新时间
|
||||
|
||||
```
|
||||
themeConfig: {
|
||||
//最后更新时间
|
||||
lastUpdated: 'Last Updated',
|
||||
}
|
||||
```
|
||||
|
|
|
|||
Loading…
Reference in New Issue