浅谈vuepress 踩坑记
更新时间：2018年04月18日 09:55:01 作者：朱亮
本篇文章主要介绍了浅谈vuepress 踩坑记，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
vuepress是尤大大4月12日发布的一个全新的基于vue的静态网站生成器，实际上就是一个vue的spa应用，内置webpack，可以用来写文档。恰好最近需要为一些组件写文档，就动手撸了一波，毕竟刚发布，遇到不少坑，最终还是磕磕碰碰的运行起来了，为了避免大家踩同样的坑，特意将搭建的过程记录下来，分享一波。
以下是几个已知的问题
因为util.promisify是在node 8.0之后引入的，所以如果你不想像我一样浪费三个小时的时间，请查看并且更新node版本
建议不要使用webpack-simple的模板进行试验，否则会各种运行不起来╮(╯▽╰)╭
使用cli的模板如果报错TypeError: Cannot read property 'vue' of undefined 是因为vuepress内置的webpack的vueloader使用的版本和你本地的不一样，请将本地的版本更新到稳定最新版本
当出现安装官方文档部署之后一直跳转到404的情况时，请使用路由的哈希模式来访问
如遇到端口冲突等问题，在docs目录下新建.vuepress文件夹，然后新建config配置文件对prot端口项进行配置即可，具体可参照官方文档
开始使用
//进入项目首先安装依赖 npm install //将vue-loader进行版本替换，使其和vuepress内置的webpack里的vue-loader保持一致，否则会报错（不过尤大大已经在解决版本冲突的问题了，版本待发） 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，具体操作请参照官方文档
剩下的主题配置参照官方文档的配置详解就OK了，这里就不在赘述
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。
相关文章
这篇文章主要介绍了Vue2.X和Vue3.0数据响应原理变化的区别，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-11-11
这篇文章主要介绍了Vue.js 中的实用工具方法，本文是小编日常开发中常用的一些工具方法，非常不错，具有一定的参考借鉴价值,需要的朋友可以参考下2019-07-07
vue+watermark-dom实现页面水印效果(示例代码)
watermark.js 是基于 DOM 对象实现的 BS 系统的水印,确保系统保密性,安全性,降低数据泄密风险,简单轻量,支持多属性配置,本文将通过 vue 结合 watermark-dom 库,教大家实现简单而有效的页面水印效果,感兴趣的朋友跟随小编一起看看吧2024-07-07
vue mounted()函数中无法定义初始化样式的原因分析
这篇文章主要介绍了vue mounted()函数中无法定义初始化样式的原因分析,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教2024-03-03
关于vue项目一直出现 sockjs-node/info?t=XX的解决办法
sockjs-node 是一个JavaScript库,提供跨浏览器JavaScript的API,创建了一个低延迟、全双工的浏览器和web服务器之间通信通道,这篇文章主要介绍了vue项目一直出现 sockjs-node/info?t=XX的解决办法,需要的朋友可以参考下2023-12-12
这篇文章主要介绍了vue实现简易图片左右旋转,上一张,下一张组件案例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-07-07
本文主要介绍了Vue3.2+Ts组件之间通信的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2022-06-06
相信大家在项目中经常会遇到一些上传下载文件的相关功能。这篇文章将为大家介绍一下Vue实现Excel本地下载及上传的示例代码，需要的可以参考一下2022-07-07
本文主要介绍了el-menu修改item颜色的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2023-04-04
这篇文章主要介绍了使用 vue-i18n 切换中英文效果，非常不错，具有一定的参考借鉴价值,需要的朋友可以参考下2018-05-05
最新评论