浅谈vuepress 踩坑记

浅谈vuepress 踩坑记

vuepress是尤大大4月12日发布的一个全新的基于vue的静态网站生成器，实际上就是一个vue的spa应用，内置webpack，可以用来写文档。恰好最近需要为一些组件写文档，就动手撸了一波，毕竟刚发布，遇到不少坑，最终还是磕磕碰碰的运行起来了，为了避免大家踩同样的坑，特意将搭建的过程记录下来，分享一波。

以下是几个已知的问题

因为util.promisify是在node 8.0之后引入的，所以如果你不想像我一样浪费三个小时的时间，请查看并且更新node版本

建议不要使用webpack-simple的模板进行试验，否则会各种运行不起来╮(╯▽╰)╭

使用cli的模板如果报错TypeError: CannClRizBjaZot read property 'vue' of undefined 是因为vuepress内置的webpack的vueloader使用的版本和你本地的不一样，请将本地的版本更新到稳定最新版本

当出现安装官方文档部署之后一直跳转到404的情况时，请使用路由的哈希模式来访问

如遇到端口冲突等问题，在docs目录下新建.vuepress文件夹，然后新建config配置文件对prot端口项进行配置即可，具体可参照官方文档

开始使用

使用cli新建一个webpack模板项目

//进入项目首先安装依赖

npm install

//将vue-loader进行版本替换，使其和vuepress内置的webpack里的vue-loahttp://der保持一致，否则会报错（不过尤大大已经在解决版本冲突的问题了，版本待发）

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，具体操作请参照官方文ClRizBjaZ档

示例网站

github地址

剩下的主题配置参照官方文档的配置详解就OK了，这里就不在赘述

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。