浅谈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 相关文章推荐
一个可拖拽列宽表格实例演示
Nov 26 Javascript
Underscore之Array_动力节点Java学院整理
Jul 10 Javascript
JavaScript获取tr td 的三种方式全面总结(推荐)
Aug 15 Javascript
你可能不知道的JSON.stringify()详解
Aug 17 Javascript
vue中echarts3.0自适应的方法
Feb 26 Javascript
Vue 去除路径中的#号
Apr 19 Javascript
Vue 中axios配置实例详解
Jul 27 Javascript
浅谈angularJs函数的使用方法(大小写转换,拷贝,扩充对象)
Oct 08 Javascript
vue项目中实现的微信分享功能示例
Jan 21 Javascript
redux.js详解及基本使用
May 24 Javascript
Vue 打包体积优化方案小结
May 20 Javascript
uniapp实现可以左右滑动导航栏
Oct 21 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
萌王史莱姆”萌王性别尴尬!那“萌战”归女组还是男?
2018/12/17 日漫
php入门学习知识点六 PHP文件的读写操作代码
2011/07/14 PHP
PHP url 加密解密函数代码
2011/08/26 PHP
PHP学习笔记(一):基本语法之标记、空白、和注释
2015/04/17 PHP
php文件包含目录配置open_basedir的使用与性能详解
2017/04/03 PHP
PHP使用PDO、mysqli扩展实现与数据库交互操作详解
2019/07/20 PHP
$()JS小技巧
2007/07/21 Javascript
JavaScript弹簧振子超简洁版 完全符合能量守恒,胡克定理
2009/10/25 Javascript
js清除input中type等于file的值域(示例代码)
2013/12/24 Javascript
动态的绑定事件addEventListener方法的使用
2014/01/24 Javascript
JQuery限制复选框checkbox可选中个数的方法
2015/04/20 Javascript
Javascript实现Array和String互转换的方法
2015/12/21 Javascript
Bootstrap每天必学之工具提示(Tooltip)插件
2016/04/26 Javascript
BootStrap智能表单实战系列(四)表单布局介绍
2016/06/13 Javascript
微信小程序商城项目之淘宝分类入口(2)
2017/04/17 Javascript
jquery 一键复制到剪切板的实例
2017/09/20 jQuery
vue实现鼠标移入移出事件代码实例
2019/03/27 Javascript
小程序开发之模态框组件封装
2020/04/23 Javascript
记一次vue跨域的解决
2020/10/21 Javascript
Vue多选列表组件深入详解
2021/03/02 Vue.js
[02:34]肉山说——泡妞篇
2014/09/16 DOTA
Python实现简单的代理服务器
2015/07/25 Python
Python内置数据结构与操作符的练习题集锦
2016/07/01 Python
python实现读取并显示图片的两种方法
2017/01/13 Python
python中nan与inf转为特定数字方法示例
2017/05/11 Python
使用 Python 玩转 GitHub 的贡献板(推荐)
2019/04/04 Python
Python数据存储之 h5py详解
2019/12/26 Python
python计算二维矩形IOU实例
2020/01/18 Python
Matplotlib使用字符串代替变量绘制散点图的方法
2020/02/17 Python
Python+Xlwings 删除Excel的行和列
2020/12/19 Python
计算机专业应届毕业生自荐信
2013/09/26 职场文书
党员三严三实对照检查材料
2014/10/13 职场文书
2014年高数考试作弊检讨书
2014/12/14 职场文书
承德避暑山庄导游词
2015/02/03 职场文书
node快速搭建后台的实现步骤
2022/02/18 NodeJs
MySQL选择合适的备份策略和备份工具
2022/06/01 MySQL