浅谈vuepress 踩坑记


Posted in Javascript onApril 18, 2018

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端口项进行配置即可,具体可参照官方文档

开始使用

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

//进入项目首先安装依赖
  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,具体操作请参照官方文档

示例网站

github地址

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

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
js变量作用域及可访问性的探讨
Nov 23 Javascript
jQuery处理xml格式的返回数据(实例解析)
Nov 28 Javascript
js图片实时加载提供网页打开速度
Sep 11 Javascript
jQuery.position()方法获取不到值的安全替换方法
Mar 13 Javascript
JavaScript实现函数返回多个值的方法
Jun 09 Javascript
javascript+css3 实现动态按钮菜单特效
Feb 06 Javascript
vue.js+boostrap项目实践(案例详解)
Sep 21 Javascript
jquery  实现轮播图详解及实例代码
Oct 12 Javascript
使用Bootstrap + Vue.js实现添加删除数据示例
Feb 27 Javascript
全面解析Node.js 8 重要功能和修复
Jun 02 Javascript
基于vue 动态加载图片src的解决方法
Feb 05 Javascript
javascript中UMD规范的代码推演
Aug 29 Javascript
使用webpack-dev-server处理跨域请求的方法
Apr 18 #Javascript
详解webpack-dev-server 设置反向代理解决跨域问题
Apr 18 #Javascript
jQuery实现的两种简单弹窗效果示例
Apr 18 #jQuery
vue双向数据绑定知识点总结
Apr 18 #Javascript
浅析vue中常见循环遍历指令的使用 v-for
Apr 18 #Javascript
关于Angularjs中跨域设置白名单问题
Apr 17 #Javascript
JS实现二维数组横纵列转置的方法
Apr 17 #Javascript
You might like
PHP中判断变量为空的几种方法小结
2013/11/12 PHP
PHP过滤黑名单关键字的方法
2014/12/01 PHP
php写入、删除与复制文件的方法
2015/06/20 PHP
Laravel5.1框架路由分组用法实例分析
2020/01/04 PHP
Thinkphp 框架配置操作之动态配置、扩展配置及批量配置实例分析
2020/05/15 PHP
javascript 网页跳转的方法
2008/12/24 Javascript
Javascript动态绑定事件的简单实现代码
2010/12/25 Javascript
JavaScript插入动态样式实现代码
2012/02/22 Javascript
jquery 事件冒泡的介绍以及如何阻止事件冒泡
2012/12/25 Javascript
IE6-IE9中tbody的innerHTML不能赋值的解决方法
2014/06/05 Javascript
javascript使用call调用微信API
2014/12/15 Javascript
JavaScript实现向OL列表内动态添加LI元素的方法
2015/03/21 Javascript
js实现touch移动触屏滑动事件
2015/04/17 Javascript
使用Node.js实现HTTP 206内容分片的教程
2015/06/23 Javascript
Bootstrap 附加导航(Affix)插件实例详解
2016/06/01 Javascript
最佳的JavaScript错误处理实践
2016/07/16 Javascript
jQuery模拟Marquee实现无缝滚动效果完整实例
2016/09/29 Javascript
JavaScript微信定位功能实现方法
2016/11/29 Javascript
js数字计算 误差问题的快速解决方法
2017/02/28 Javascript
ssm+vue前后端分离框架整合实现(附源码)
2020/07/08 Javascript
python使用matplotlib绘制折线图教程
2017/02/08 Python
Python基于高斯消元法计算线性方程组示例
2018/01/17 Python
python实现socket+threading处理多连接的方法
2019/07/23 Python
Python调用shell命令常用方法(4种)
2020/05/11 Python
基于Django快速集成Echarts代码示例
2020/12/01 Python
俄罗斯香水和化妆品网上商店:NOTINO.ru
2019/12/17 全球购物
主持人演讲稿范文
2013/12/28 职场文书
婚假请假条怎么写
2014/04/10 职场文书
班级心理活动总结
2014/07/04 职场文书
2015年安全生产责任书
2015/01/30 职场文书
技术支持岗位职责
2015/02/13 职场文书
2015大学生党员自我评价范文
2015/03/03 职场文书
2015年人事工作总结范文
2015/04/09 职场文书
寒假致家长的一封信
2015/10/10 职场文书
房地产置业顾问工作总结
2015/10/23 职场文书
Go语言的协程上下文的几个方法和用法
2022/04/11 Golang