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

开始使用

使用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了,这里就不在赘述

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

您可能感兴趣的文章:

相关文章

  • vue 系列——vue2-webpack2框架搭建踩坑之路

    vue 系列——vue2-webpack2框架搭建踩坑之路

    本文从零搭建vue项目,给大家分享了我的vue2-webpack2框架搭建踩坑之路,需要的朋友可以参考下
    2017-12-12
  • vue项目中使用vue-i18n报错的解决方法

    vue项目中使用vue-i18n报错的解决方法

    这篇文章主要给大家介绍了关于vue项目中使用vue-i18n报错的解决方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-01-01
  • 详解vue-cli中模拟数据的两种方法

    详解vue-cli中模拟数据的两种方法

    这篇文章主要介绍了vue-cli中模拟数据的两种方法,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-07-07
  • Vue实现回到顶部和底部动画效果

    Vue实现回到顶部和底部动画效果

    这篇文章主要为大家详细介绍了Vue实现回到顶部和底部动画效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-07-07
  • Vue组件实现触底判断

    Vue组件实现触底判断

    这篇文章主要为大家详细介绍了Vue组件实现触底判断,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-06-06
  • 浅析vue-router中params和query的区别

    浅析vue-router中params和query的区别

    这篇文章主要介绍了vue-router中params和query的区别,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-12-12
  • 在vue项目中使用md5加密的方法

    在vue项目中使用md5加密的方法

    这篇文章主要介绍了在vue项目中使用md5加密的方法,需要的朋友可以参考下
    2018-09-09
  • 详解Vue快速零配置的打包工具——parcel

    详解Vue快速零配置的打包工具——parcel

    本篇文章主要介绍了详解Vue快速零配置的打包工具——parcel,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • 解决vue-router中的query动态传参问题

    解决vue-router中的query动态传参问题

    下面小编就为大家分享一篇解决vue-router中的query动态传参问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • vue父子组件间引用之$parent、$children

    vue父子组件间引用之$parent、$children

    这篇文章主要介绍了vue父子组件间引用之$parent、$children的相关知识,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-05-05

最新评论