浅谈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 相关文章推荐
javascript之ESC(第二类混淆)
May 06 Javascript
用js代码改变单选框选中状态的简单实例
Dec 18 Javascript
利用Vue.js指令实现全选功能
Sep 08 Javascript
微信小程序 Page()函数详解
Oct 17 Javascript
BootStrap Datepicker 插件修改为默认中文的实现方法
Feb 10 Javascript
jQuery按需加载轮播图(web前端性能优化)
Feb 17 Javascript
详解vue.js移动端导航navigationbar的封装
Jul 05 Javascript
深入浅析Vue.js 中的 v-for 列表渲染指令
Nov 19 Javascript
qrcode生成二维码微信长按无法识别问题的解决
Apr 04 Javascript
egg.js的基本使用和调用数据库的方法示例
May 18 Javascript
QML实现圆环颜色选择器
Sep 25 Javascript
jQuery操作事件完整实例分析
Jan 10 jQuery
使用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 pathinfo()获得文件的路径、名称等信息说明
2011/09/13 PHP
Laravel中使用阿里云OSS Composer包分享
2015/02/10 PHP
PHP单链表的实现代码
2016/07/05 PHP
PHP异步进程助手async-helper
2018/02/05 PHP
php提供实现反射的方法和实例代码
2019/09/17 PHP
json数据处理技巧(字段带空格、增加字段、排序等等)
2013/06/14 Javascript
JS 使用for循环遍历子节点查找元素
2014/09/06 Javascript
js超时调用setTimeout和间歇调用setInterval实例分析
2015/01/28 Javascript
JS+CSS实现Li列表隔行换色效果的方法
2015/02/16 Javascript
JavaScript操作Cookie方法实例分析
2015/05/27 Javascript
Bootstrap入门书籍之(三)栅格系统
2016/02/17 Javascript
总结jQuery插件开发中的一些要点
2016/05/16 Javascript
JS轮播图实现简单代码
2021/02/19 Javascript
纯js封装的ajax功能函数与用法示例
2018/05/14 Javascript
解析vue路由异步组件和懒加载案例
2018/06/08 Javascript
jsonp跨域及实现百度首页联想功能的方法
2018/08/30 Javascript
vue发送ajax请求详解
2018/10/09 Javascript
Node.js console控制台简单用法分析
2019/01/04 Javascript
vue.js使用v-model实现表单元素(input) 双向数据绑定功能示例
2019/03/08 Javascript
微信小程序获取复选框全选反选选中的值(实例代码)
2019/12/17 Javascript
js数据类型转换与流程控制操作实例分析
2019/12/18 Javascript
[01:45]DOTA2新英雄“神谕者”全方位展示
2014/11/21 DOTA
python高效过滤出文件夹下指定文件名结尾的文件实例
2018/10/21 Python
django商品分类及商品数据建模实例详解
2020/01/03 Python
python实现企业微信定时发送文本消息的示例代码
2020/11/24 Python
俄罗斯旅游网站:Tripadvisor俄罗斯
2017/03/21 全球购物
法拉利英国精品店:Ferraris Boutique UK
2019/07/20 全球购物
金融专业个人求职信
2013/09/22 职场文书
大学生收银员求职信分享
2014/01/02 职场文书
仓库组长岗位职责
2014/01/29 职场文书
《晏子使楚》教学反思
2014/02/08 职场文书
新学期教师寄语
2014/04/02 职场文书
数据库之SQL技巧整理案例
2021/07/07 SQL Server
python实现MD5进行文件去重的示例代码
2021/07/09 Python
golang定时器
2022/04/14 Golang
Mysql将字符串按照指定字符分割的正确方法
2022/05/30 MySQL