vuepress建站过程中遇到的一些问题

页面显示-404

在 vuepress 说明了文件路径与页面路由之间的映射关系

当你访问 /guide/ 而 404 时,这是由于 guide 目录下缺乏了它对应的 README.md 文件

侧边栏显示的是文件路径，而非文件名

当您的md文件没有任何内容时,就会显示文件路径,如 /read/lingdu/wanted.html) ,如下所示

这是由于你的 md 文件中缺乏标题导致的，标题的产生有两种方式

添加 Front Matter 的 title 属性

---
title: 标题

1. markdown 语法中的添加标题

# 一级标题
## 二级标题

自动化-bash-deploy.sh-脚本不成功

• 您可以把 deploy.sh 中的 set -e 给注释掉的,然后在执行 bash deploy.sh ,或者就是手动向远程 push 操作的
• 克隆远程仓库与 deploy.sh 中推向的 git 仓库不一致,是 https 方式的还是 ssh 方式的,要一一对应

markdown-中引入图片不显示

建议与文章相关的图片放置在同级目录下,而不要放置在 .vuepress/public/ 目录中

─README.md
├─fontend
|    ├─tools      // 与工具相关的文章
|    |   ├─README.md
|    |   └vuepress-build-blog.md
|    ├─js          // js相关的文章
|    | ├─README.md
|    | ├─scope.md
|    | └understand-closure.md
|    ├─images           // 所有与md相关的图片放在在images目录下的
|    |   ├─tools-article-imgs  // 与工具相关文章的图片
     |   |     ├─vuepress-build-blog  // 手把手教你用vuepress搭建博客文章相关图片
|    |   |     |     ├─404-page.png
|    |   |     |     ├─baidutongji-0.png
|    |   ├─js-article-imgs
|    |   ├─css-article-imgs
|    ├─css
|    |  ├─elem-center.md
|    |  ├─flexible-box.md
|    |  └README.md
├─about
|   ├─about.md
|   └README.md

与路径相关内容静态资源文档

安装某插件后不生效

在当前项目中安装 plugin-back-to-top- 或 -pwa- 等插件后,发现不生效,其他插件也是如此

原因 :本地项目未安装 vuepress ,因为一些第三方插件依赖 vuepress ,除了全局坏境下安装了 vupress ,当前项目下也得安装

解决 :在本地的 package.json 中检查 vuepress 是否有安装,若没有则用 npm install -D vuepress 安装一下

"devDependencies": {
  "@vuepress/plugin-back-to-top": "^1.5.0",
  "vuepress": "^1.5.0",

热更新问题

在 vuepress 1.5.0 之前的版本中,若 md 文件或者其他配置文件(或自定义组件)有所更改,页面内容并不会马上更新,每次都需要重新 npm run docs:dev ,热更新存在一些问题

解决 :只需使用 npm 升级 vuepress 的版本即可,在 vuepress:^1.5.1 中此问题已经解决

npm install -D vuepress@next
// 在当前项目的package.json中就会看到vuepress的最新版本
"vuepress": "^1.0.0-rc.1",

这个 rc 代表的是（ Release Candidate ）候选版本。系统平台上就是发行候选版本。 RC 版不会再加入新的功能了，主要着重于除错 当然,网上也有说在 package.json ,添加如下代码也可以解决,可自行测试

resolutions: {
  "watchpack":"1.7.2"