VuePress搭建Wiki站
# 为什么要更换
博客原本写的内容比较乱,主要是按照发布时间倒序排列,另外有分类和标签可以提供合集类的索引,有搜索功能可以直接查阅。
但对于博客里占大多数篇幅的技术文章,之前的方式来整理并没有那么好。尤其是围绕某个主题的系列文章,需要单独建一个导航页置顶起来。
这些有主题的文章,都可以通过类似于docs的方式做整理,左侧就有导航栏,系列里面有哪些内容一目了然,查阅起来很方便。而且技术类文章的发布时间先后并不重要,能够整理成有条理的体系似乎更关键,将来也可以及时修订更新。
再加上 VuePress 主题的风格也很漂亮(其实这才是重点 = =),第一次看到时就吸引了我。Vdoing 这个主题维持了默认主题的简洁大方风格,同时也有很多实用的改进和补充,所以就选择它了。
# 折腾起来
参照 vuepress-theme-vdoing (opens new window) 的文档,熟悉了 vuepress 的目录结构和配置项,很快就能上手弄起来。
将原本就是 markdown 的博文做一次迁移,写了脚本从原来的数据库里批量导出了这些 markdown 文本,按照需要写到一个个文件里。不过,文章的永久链接发生了变化,所以额外生成了一些静态 html 做跳转,我也不是太喜欢原本数字递增的链接方式,趁此机会正好替换掉。
这次也顺便尝试了 Github Actions。感觉确实很方便,因为市场里提供了很多好用的 Actions,只要稍加配置,就可以实现丰富的功能,比如每次提交后,自动 build 并且部署到 Github Pages。
目前这个站点还是部署在一台国内的云服务器上,所以在折腾 Github Actions 自动部署的时候,费了一番工夫。但最后让我哭笑不得的是,当我终于把流程走通之后,因为我的服务器在国内,这个跨境访问实在是太慢了,我本地几秒钟就能完成的部署,在 Actions 里跑了半小时后也没完成,似乎卡住了。所以这项暂时只好作罢,考虑到我的服务器 git clone 也很慢,npm run build 就更别想了,我还是手动上传文件更新吧😭。
# 所以
所以,这个美观大方的新 Wiki 站点就完成啦,我也理清了手头两个域名的使用计划。 CodingCat 这里只记录与技术相关的事情,会有另外文艺气息较为浓厚的博客来写写生活点滴。
回头看看我的博客折腾经历,感觉真是有过不少尝试了,csdn/博客园/简书/知乎专栏/segmentFault 这些平台都试过,jekyll/hexo 静态生成也用过,前几天还在折腾 Gatsby(之前在v2看有人说这个挺厉害,反正我觉得不太好用)。hexo 丢了文章之后自己用 Django 写了个界面简陋的博客,稳定用了两年,今天算是正式迁移到 VuePress 了,也不知道能用多久。
如果把折腾博客系统的工夫拿来好好写文章,是不是会更好点呢 /doge