浅谈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 相关文章推荐
FormValidate 表单验证功能代码更新并提供下载
Aug 23 Javascript
基于jquery的跨域调用文件
Nov 19 Javascript
js同比例缩放图片的小例子
Oct 30 Javascript
使用jQuery不判断浏览器高度解决iframe自适应高度问题
Dec 16 Javascript
用队列模拟jquery的动画算法实例
Jan 20 Javascript
深入理解JavaScript中的预解析
Jan 04 Javascript
各种选择框jQuery的选中方法(实例讲解)
Jun 27 jQuery
Django与Vue语法的冲突问题完美解决方法
Dec 14 Javascript
解决Jquery下拉框数据动态获取的问题
Jan 25 jQuery
jquery实现Ajax请求的几种常见方式总结
May 28 jQuery
Js通过AES加密后PHP用Openssl解密的方法
Jul 12 Javascript
MockJs结合json-server模拟后台数据
Aug 26 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 set_magic_quotes_runtime() 函数过时解决方法
2010/07/08 PHP
解析PHP处理换行符的问题 \r\n
2013/06/13 PHP
如何在php中正确的使用json
2013/08/06 PHP
Win7 64位系统下PHP连接Oracle数据库
2014/08/20 PHP
js判断浏览器类型的方法
2013/08/07 Javascript
extjs4 treepanel动态改变行高度示例
2013/12/17 Javascript
页面js遇到乱码问题的解决方法是和无法转码的情况
2014/04/30 Javascript
Underscore.js常用方法总结
2015/02/28 Javascript
简易的投票系统以及js刷票思路和方法
2015/04/07 Javascript
jQuery满屏焦点图左右滚动特效代码分享
2015/09/07 Javascript
JS+CSS实现简单滑动门(滑动菜单)效果
2015/09/19 Javascript
js面向对象之常见创建对象的几种方式(工厂模式、构造函数模式、原型模式)
2015/11/09 Javascript
jsonp跨域请求数据实现手机号码查询实例分析
2015/12/12 Javascript
深入学习AngularJS中数据的双向绑定机制
2016/03/04 Javascript
javascript对象的创建和访问
2016/03/08 Javascript
js 声明数组和向数组中添加对象变量的简单实例
2016/07/28 Javascript
完美解决node.js中使用https请求报CERT_UNTRUSTED的问题
2017/01/08 Javascript
脚本div实现拖放功能(两种)
2017/02/13 Javascript
关于前后端json数据的发送与接收详解
2017/07/30 Javascript
es6 字符串String的扩展(实例讲解)
2017/08/03 Javascript
微信小程序http连接访问解决方案的示例
2018/11/05 Javascript
详解webpack编译速度提升之DllPlugin
2019/02/05 Javascript
Vue.js 中制作自定义选择组件的代码附演示demo
2020/02/28 Javascript
python中常用的各种数据库操作模块和连接实例
2014/05/29 Python
解决python2.7用pip安装包时出现错误的问题
2017/01/23 Python
selenium在执行phantomjs的API并获取执行结果的方法
2018/12/17 Python
Dlib+OpenCV深度学习人脸识别的方法示例
2019/05/14 Python
如何给Python代码进行加密
2020/01/10 Python
意大利体育用品网上商城:Nencini Sport
2016/08/18 全球购物
英国在线房屋中介网站:Yopa
2018/01/09 全球购物
Feelunique美国:欧洲大型的在线美妆零售电商
2018/11/04 全球购物
土地转让协议书
2014/09/27 职场文书
2015年中个人总结范文
2015/03/10 职场文书
Python超简单容易上手的画图工具库推荐
2021/05/10 Python
使用Apache Camel表达REST服务的方法
2022/06/10 Servers
MySQL提升大量数据查询效率的优化神器
2022/07/07 MySQL