添加链接
link之家
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
vuepress采坑总结,搭建个人博客常见报错

不显示内容区

大概率是markdown文件书写不规范,可能是md文件中某些特殊符号没括起来:如 {{}} 没有用`` 括起来,可以先拷贝一份自己的笔记,使用 二分法 删除自己的部分笔记,逐步定位到不规范的书写位置

提交到github后页面无变化

确定自己提交的分支 比如我是提交到gh-pages,所以pages中要选这个分支

npm run deploy 一直报错

bash环境

由bash deploy.sh知,因为需要bash环境,所以我们得先安装bash,但是因为git bash里自带了bash,所以在项目中打开git bash命令窗口,输入npm run deploy,

dist目录

如果一直显示 dist找不到的问题 ,那就有可能是dist生成在了错误的地方

比如我没使用dest属性,那他会生成在.vuepress下,如果我使用了dest: './dist',那他就会生成在docs下

ssh秘钥未配置

打开github的settings,new SSH key 添加秘钥 如果不知道怎么查看自己的秘钥,可以看下这篇文章 www.runoob.com/w3cnote/vie…

heroImage首页图片不显示

有时,你可能需要提供一个静态资源,但是它们并不直接被你的任何一个 markdown 文件或者主题组件引用 —— 举例来说,favicons 和 PWA 的图标,在这种情形下,你可以将它们放在 .vuepress/public 中, 它们最终会被复制到生成的静态文件夹中, 即要把 heroImage首页图片图片放到 ,然后在heroImage处用 ./ 引用

窗口图片不显示

你将需要在 .vuepress/config.js 中设置 base ,举例来说,如果你打算将你的网站部署到 https://foo.github.io/docs/ ,那么 base 的值就应该被设置为 "/docs/" (应当总是以斜杠开始,并以斜杠结束)。

上线后点击导航栏一直跳转不过去

有可能是github内部故障了,明天试试就好了,我就遇到这样的情况

上线后侧边栏分级错误

侧边栏分级vuepress有严格的规范 首先确定sidebar有几个title,然后再逐一处理title里的分级

css初级中有多少个markdown文件,就对应多少个children

每个markdown文件中只能有一个h1,以及多个h2

每个人配置的环境不尽相同,比如我的vuepress是"^1.9.2",我的目录结构也不一定和你们相同,所以遇到报错一定要先看报错原因,借助浏览器调试工具和vuepress官方文档查找错误,还是不行可以找朋友一起尝试解决这个bug。

分类:
前端
标签: