vuepress是尤大大4月12日发布的一个全新的基于vue的静态网站生成器,实际上就是一个vue的spa应用,内置webpack,可以用来写文档。恰好最近需要为一些组件写文档,就动手撸了一波,毕竟刚发布,遇到不少坑,最终还是磕磕碰碰的运行起来了,为了避免大家踩同样的坑,特意将搭建的过程记录下来,分享一波。
以下是几个已知的问题
因为util.promisify是在node 8.0之后引入的,所以如果你不想像我一样浪费三个小时的时间,请
建议不要使用webpack-simple的模板进行试验,否则会各种运行不起来╮(╯▽╰)╭
使用cli的模板如果报错TypeError: Cannot read property 'vue' of undefined 是因为vuepress内置的webpack的vueloader使用的版本和你本地的不一样,请将本地的版本更新到稳定最新版本
当出现安装官方文档部署之后一直跳转到404的情况时,请使用路由的哈希模式来访问
如遇到端口冲突等问题,在docs目录下新建.vuepress文件夹,然后新建config配置文件对prot端口项进行配置即可,具体可参照官方文档
开始使用
使用cli新建一个webpack模板项目
npm update vue-loader@15.0.0-rc.2 --save-dev
//接下来安装vuepress
npm install -D vuepress
mkdir docs
echo "# Hello VuePress!" > docs/README.md
//最后一步启动vuepress ,进入docs目录,使用vuepress dev命令即可
cd docs
vuepress dev
//使用vuepress build即可完成对项目的打包
//接下来就是按照官方的文档,对你的网站进行各种创造啦
项目部署的话我使用的是github,具体操作请参照官方文档
@L_502_3@
剩下的主题配置参照官方文档的配置详解就OK了,这里就不在赘述