返回博客
Site notes2026-04-298 min

把个人站点当成长期系统来设计

真正决定个人站点能不能长期运行的,不是首页有多漂亮,而是内容、目录、路由和更新方式有没有先被设计清楚。

把个人站点当成长期系统来设计

如果一个个人站点以后会不断增加文章、项目复盘、阶段总结和公开表达,那么它首先不是视觉问题,而是系统问题。

先解决的不是首页,而是内容怎么长进去

这次真正花时间确认的,不是 hero 文案,也不是首页卡片长什么样,而是几个更基础的问题:

  • 公开内容和私有知识库怎么分层
  • 中英双语应该放在 URL 层还是页面内部
  • 文章和项目的详情页是否都由内容文件驱动
  • 后续加图片、图表或附件时,目录是不是还扛得住

这些问题如果一开始没想清楚,内容一多,站点就会重新变成“每更新一次都要改结构”的状态。

为什么现在改成了 locale + MDX + 目录式条目

现在公开站点的内容目录已经改成了:

content/blog/zh/<slug>/index.mdx
content/blog/en/<slug>/index.mdx
content/projects/zh/<slug>/index.mdx
content/projects/en/<slug>/index.mdx

这么做有三个直接好处。

第一,双语内容不需要在同一个文件里来回切换,URL 也天然清楚。

第二,每篇内容都有自己的目录,后续加插图、导图、封面和附件时,不需要再额外设计组织方式。

第三,页面结构和内容本身已经脱钩。新增一篇文章,本质上只是新增一个目录和一个 index.mdx,不是再写一套新的 React 页面。

为什么知识库继续保留为私有

知识库承担的是内部沉淀、结构化笔记、半成品判断和长期维护材料。它和博客不是同一种东西。

博客要面向读者组织表达,知识库则更像工作仓库,允许内容不完整、允许目录先于结论、允许长期追加修改。

如果把这两类内容硬放到同一个公开站点语义里,读者会混淆,维护者也会混淆。最后的结果通常是两边都变差。

所以这次选择非常直接:知识库继续留在仓库里,只作为内容存储,不公开生成路由;真正适合公开的内容,再从里面整理成文章或项目复盘发出来。

这套结构现在已经能承担什么

现在的网站已经不是“未来规划”,而是一套可以继续往里填内容的底盘:

  • 首页会自动读取最近的文章和项目
  • 博客和项目都有可复用的详情页模板
  • 中英双语内容是并行维护的,而不是临时翻译
  • 目录已经适合继续加入图片和附件

下一步的重点不会是继续做更多页面,而是持续增加真实内容,让这个站点看起来像真实在运行,而不是只展示一个框架。