2024-12-25 开源项目 vuepress-theme-vdoing 1576 字 6 分钟 -- 次

vdoing FAQ

最后更新于: 2026-06-27 15:38:29

问答

我为什么要从docusaurus迁移到vdoing

1、docusaurus首页没标签/分类/站点信息等特性

docusaurus首页：

PixPin_2024-12-24_19-49-36

vdoing首页：

PixPin_2024-12-24_19-51-30

2、docusaurus原作者不再更新项目了🤣

3、vue生态很不错，但docusaurus生态不咋的

4、vdoing的确不错哇，知识库+博客

最后：迁移docus数据到vdoing

docus数据

这个是在坚果云里已经同步了的，且是docus站内内容：

https://onedayxyy.cn/

为了不损坏原来docus网站数据，这里把关键md拷贝一份到百度云同步空间里：然后从这个目录里迁移数据就行（以后禁止更新老目录里的内容）

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

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

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

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

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

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

首先让项目正常的跑起来
根据需求构建和替换 [docs/<结构化目录>](https://doc.xugaoyi.com/pages/2f674a/) 的目录及内容
根据需求修改 config.js 配置
修改首页配置
修改主题颜色和样式（如果你想修改的话）

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

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

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

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

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

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

是否支持国际化？

答：暂不支持。目前的国际化方案，只能是使用不同项目来处理，比如：一个项目是中文，一个项目是英文，在导航中添加中英文站点的链接。

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

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

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

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

什么情况下，我才需要升级呢？

2024年12月24日提出问题。

问题：什么情况下，我才需要升级呢？

升级后，是否会影响我现在项目的正常运行呢？？？😜

cdn问题（已闭环）

环境

2024年12月23日测试

基于官方https://github.com/xugaoyi/vuepress-theme-vdoing搭建的仓库。

故障现象

讨论过程

b12efcd088cae705c49307b82c4dbae

待进一步测试

我的域名是配置了cdn的

当前自己web状态如下

这里是空的

开始推送数据到云服务器

推送完成

2024年12月24日12:48:51

待观察效果

清空浏览器缓存：

再次验证：（web没出现新内容）

这里等待数个小时，再次观察下效果

这里刷新下网页，新的内容就会更新出来的。那就是没问题的哈哈。😜😜😜

结论

已闭环。没啥问题的，我们正常使用cdn加速域名，正常更新内容就好。😜😜😜

2024年12月24日

我更换了目录后，那么该文档的分类是不会自动改变的哇？（待解决）