当前位置: 首页 > 编程笔记 >

浅谈vuepress 踩坑记

慕阳
2023-03-14
本文向大家介绍浅谈vuepress 踩坑记,包括了浅谈vuepress 踩坑记的使用技巧和注意事项,需要的朋友参考一下

vuepress是尤大大4月12日发布的一个全新的基于vue的静态网站生成器,实际上就是一个vue的spa应用,内置webpack,可以用来写文档。恰好最近需要为一些html" target="_blank">组件写文档,就动手撸了一波,毕竟刚发布,遇到不少坑,最终还是磕磕碰碰的运行起来了,为了避免大家踩同样的坑,特意将搭建的过程记录下来,分享一波。

以下是几个已知的问题

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

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

 类似资料:
  • 本文向大家介绍VuePress 快速踩坑小结,包括了VuePress 快速踩坑小结的使用技巧和注意事项,需要的朋友参考一下 最近有个开源项目非常火,那就是尤小右开发的 VuePress,VuePress 可以让您非常方便的在 Markdown 文档中编写 Vue 代码,并且 VuePress 对编译后的 HTML 文件做了一些针对搜索引擎的优化。另外 VuePress 针对 Markdown 文件

  • 本文向大家介绍谈谈php对接芝麻信用踩的坑,包括了谈谈php对接芝麻信用踩的坑的使用技巧和注意事项,需要的朋友参考一下 由于项目需要,接入芝麻信用对用户进行认证,打开芝麻信用官方网站( https://b.zmxy.com.cn/index.htm)查看官方demo,在文档中看到如图 瞬间觉得这个官方demo的垃圾了。 在其中有需要注意如下: 1.本地生成密钥,可以按照提示进行生成 2.在“商家管

  • JavaScript-StepPitGuide《JavaScript踩坑指南》,那些说前端简单的什么的最变态了,可以说 JavaScript 是世界上最复杂的语言。

  • 本文向大家介绍浅谈Three.js截图并下载的大坑,包括了浅谈Three.js截图并下载的大坑的使用技巧和注意事项,需要的朋友参考一下 最近做有关three.js的动画,想通过截图然后在新的页面打开截图,并且想把图片下载到本地,连环坑很ok:ok_hand:嗯。这个必须要记下来! 先来看看普通页面的截图 一开始看到这个,完全没思路,普通的html标签要怎么才能变成一张图???,其实嘞,目前的截图方

  • 本文向大家介绍java学习之JasperReport踩坑,包括了java学习之JasperReport踩坑的使用技巧和注意事项,需要的朋友参考一下 下面进入正题,来介绍下今天的猪脚JasperReport或者叫它ireport亦或jasperstudio,当然后面两个是它的可视化工具。 JasperReport是个什么东西? 这货其实在国内用户也不少,是个国外的产品,而且可以说在JAVA报表领域应

  • 其实在重写 WeUI 的过程中,主要是重写了一些组件,可能还没有遇到 mpvue 框架关于数据交互以及其他方面的问题,因此主要踩了两个坑,在下面声明一下: 1. 小程序原生组件事件绑定的写法 先举一个简单的例子,在小程序的原生组件中有 checkbox-group,picker,slider等等,以picker组件为例,它有一个类型为 EventHandle 的 bindchange 属性,在小程