问答

我是一个小白，想使用这个主题搭建博客（知识库）需要做哪些工作？

答：使用这个主题前需要你掌握下面这些知识：

  • 掌握 markdown、yaml 语法
  • 会使用终端（命令行），会使用 git
  • 会阅读文档、搜索文档
  • 会VuePress的基本使用和默认主题的基本配置

以上知识都掌握之后，再查看本文档。你也可以运行我的主题项目，一边看代码，一边查看文档。主题项目内写了比较多的注释代码，方便你的学习和使用。

clone 项目后需要修改哪些地方？

答：大致的修改流程是这样的：

  1. 首先让项目正常的跑起来
  2. 根据需求构建和替换 docs/<结构化目录> 的目录及内容
  3. 根据需求修改 config.js 配置
  4. 修改 首页配置
  5. 修改 主题颜色和样式（如果你想修改的话）

可减少项目冗余的地方有哪些？

答：在完成项目的搭建之后，对于没有使用到的一些文件和代码，可以看情况删减，可删减的地方有:

  • 卸载config.js中未使用的插件依赖包
  • 参照 目录结构，删除未使用到的 可选 文件
  • 删除.vusepress目录内未使用到的 可选 文件
  • 删除各文件内的注释代码

我可以不使用永久链接吗？

答：不可以。当你没有在front matter指定永久链接时，主题会自动生成永久链接到front matter，你可以修改永久链接的值。 使用永久链接是出于以下几点考虑:

  1. 在config.js配置nav时使用永久链接，就不会因为文件的路径或名称的改变而改变。
  2. 对于博客而言，当别人收藏了你的文章，在未来的时间里都可以通过永久链接来访问到。
  3. 主题中的目录页需要通过永久链接来访问文章。

打包后在本地预览怎么没有样式？

答：因vuepress打包后的CSS、JS等资源链接采用绝对路径引入，在本地预览时的引入链接是不正确的，部署到服务器即可正常引入和预览。如果你确实需要本地预览，可以使用vuepress-plugin-serve插件，使用方法看相应文档。

在build时出现错误，但是在dev时是正常的

答：这种情况多半是因为你在created或beforeCreate生命周期调用了浏览器API的原因导致，详情查看：浏览器的 API 访问限制