1)VuePress是什么？

先让我们看看 VuePress能干什么？有什么效果？

image.png

很像vue官网的文档页面，因为vuePress就是尤大大的一个力作

vuePress官网介绍介绍的很详细，这里只做搭建VuePress项目教程

2)安装

注意 VuePress基于node 8.0+

npm install -g vuepress

创建工作文件夹 study

进入文件夹

快速初始化package.json

npm init -y

2.1 新建文件夹docs

配置package.json，添加下述兩行

{

"scripts": {

"docs:dev": "vuepress dev docs",

"docs:build": "vuepress build docs"

}

}

进入docs文件夹 创建 README.md文件

此时运行命令

npm run docs:dev

此时文件夹结构

study

+--docs

+----README.md

+--package.json

image.png

结束运行 ，执行命令

npm run docs:build

然后看文件变化 多了个node_modules

docs 多了个 .vuepress文件夹

study

+--docs

+----.vuepress

+------ dist //打包后的文件夹

+----README.md

+--package.json

+--node_modules

我们在.vuepress 创建

config.js 文件

添加

module.exports = {

title: 'Adroi媒体API 接口文档', // 设置网站标题

description : 'Adroi',

base : '/v1/adroi-h5/adroiapi/',

themeConfig : {

nav : [

{ text: '接口定义', link: '/apiword' },

{ text: '接口字段定义', link: '/api' },

{ text: '附录：错误码', link: '/error' }

],

sidebar: {

'/' : [

"/", //指的是根目录的md文件 也就是 README.md 里面的内容

"apiword", 根目录创建 apiword.md文件

"api",根目录创建 api.md文件

"error" 根目录创建 error.md文件

]

},

sidebarDepth : 2

}

}

image.png

3)添加静态图片


4)添加指定样式

添加样式 分两种 一种不用预编译处理、一种使用

//不使用预编译处理

//直接在md文件底部添上

//使用预编译处理

首先需要安装所需的模块 举例：stylus

npm i stylus stylus-loader -D

5)vuePress可添加js代码

既然是尤大大的作品 那肯定是支持vue语法的

在MD文件中直接写入js的语法

export default{

//...do something

}

6)代码发布或上传至服务器

关于发布问题：首先我们知道在打包后的文件都是静态文件之前的MD文件都被打包成html静态文件了,其次在文件config.js中 base至关重要

6-1发布在云盘中如百度云盘 github上可直接通过链接访问

在云盘上创建根目录如vuepress，然后在config中 bese这部分就填写/vuepress,然后进行打包操作，再然后把打包后的文件上传至云盘上的vuepress文件中

6-2 通过服务器发布

在服务器上安装Apache或者nginx 这里拿nginx举例：

至于nginx 安装 以及配置文件的解读使用 我这里就不详述了，不了解的童鞋可以自己查阅相关文件

同样base的填写很重要

//为了简单明了 我们把打包好的文件放入nginx中html文件下 之前的文件可以清空

server {

listen 8081; //监听8081端口

server_name localhost; //localhost:8081即可指向也可写别名如local.vuepress.com.cn 那我们访问这个端口的别名加端口就可以

location / {

root /nginx/nginx-1.9.15/html; //至关重要你的入口文件在本机的位置

index index.html index.htm; //入口文件

}

}

6-3可以通过koa启用服务发布

具体代码不详述：可通过koa来学习