Colophon

这个站怎么造的

站点自身也是作品。这一页同时是留给未来自己的重建手册。

三层解耦

内容层是纯 Markdown + frontmatter 与 JSON,配图全部本地化;构建层是 scripts/build.mjs(零 npm 依赖),产出纯静态 HTML;身份层是自有域名,托管只是 DNS 里的一条 CNAME。

重建命令

node scripts/build.mjs
# 产物在 dist/,整个目录可直接部署到任意静态托管

为什么审阅版不用 Astro

已确认的主干方案是 Astro/11ty + Markdown。这一版为了让你现在就能打开审阅、且任何时候都能重建,构建器故意零依赖;源目录已按 Astro 约定组织(content / layouts / styles / scripts),URL 与内容结构都已冻结。确认视觉后把构建器换成 Astro 的 content collections 即可,页面地址一个都不用改。

发布渠道

每篇文章的 frontmatter 里 channels: [site, wechat, video] 决定分发去向:网站是唯一权威版本,公众号走草稿箱 API(自动排版与传图,人工点发布),视频脚本与素材由同一份源派生。发布后即冻结,修订只在主站发生。

长期约定

  • 构建产物 dist/ 随源码一起提交,生成器挂了网站依然在线。
  • 所有图片、字体、脚本本地化,不用外链 CDN。
  • URL 由文件名推导,发布即冻结;改名靠 aliases 与重定向表。
  • 每年导出整站快照,域名开启自动续费与注册商锁定。

内容许可

文字与示意图默认保留所有权利;开源代码仓库按各自 LICENSE。转载或引用请先邮件联系。

占位内容

姓名、域名、外链、项目与文章中的测量数据均为示例,替换后即可正式上线。