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 页面。
为什么知识库继续保留为私有
知识库承担的是内部沉淀、结构化笔记、半成品判断和长期维护材料。它和博客不是同一种东西。
博客要面向读者组织表达,知识库则更像工作仓库,允许内容不完整、允许目录先于结论、允许长期追加修改。
如果把这两类内容硬放到同一个公开站点语义里,读者会混淆,维护者也会混淆。最后的结果通常是两边都变差。
所以这次选择非常直接:知识库继续留在仓库里,只作为内容存储,不公开生成路由;真正适合公开的内容,再从里面整理成文章或项目复盘发出来。
这套结构现在已经能承担什么
现在的网站已经不是“未来规划”,而是一套可以继续往里填内容的底盘:
- 首页会自动读取最近的文章和项目
- 博客和项目都有可复用的详情页模板
- 中英双语内容是并行维护的,而不是临时翻译
- 目录已经适合继续加入图片和附件
下一步的重点不会是继续做更多页面,而是持续增加真实内容,让这个站点看起来像真实在运行,而不是只展示一个框架。