从零到能打开,花了两个晚上。记一下每一步在干什么,以及哪些是白学的。

建站VitePress

这个站是怎么搭起来的 ​

先写结论:壳子两小时能搭完,剩下的时间全花在想清楚要写什么上。

为什么不用 WordPress ​

一开始想的是 WordPress,能装插件、有后台。后来发现两个问题:

  • 要租服务器,还要管数据库、管备份,一年几百块
  • 主题改起来要么很丑,要么要写一堆 PHP

我要的东西很简单:写 Markdown,git push,网站更新。那就该用静态生成器。

为什么最后是 VitePress ​

试过三个:

方案好在哪卡在哪
Hexo主题多,文章多前端版本老,改样式费劲
Astro自由,生态大文章列表、分页、搜索都得自己写
VitePress搜索、目录、中文排版开箱即用博客功能要自己补一点

VitePress 本来是写文档的,但我要的正好也是"一堆 Markdown 变成好看的网页"。 它缺的分类页、标签页,用一个构建时脚本读 frontmatter 生成就行,一次写完不用再管。

目录结构想说的事 ​

文章放在 docs/blog/<大类>/<文件名>.md,分类由路径决定,不用在文件里手写分类名。

text
docs/blog/
  tech/        技术
  humanity/    人文
  growth/      成长

加一篇新文章 = 新建一个 md 文件,push。列表页会自动多一条。

还没解决的 ​

  • 图片还没地方放,暂时塞 public 里
  • 评论要不要开,没想好
  • 统计要不要接,也没想好

这些等真有内容了再说。