ARTICLE · 1124615
把 OpenClaw.NET 的 83 篇 Markdown 变成一
把 OpenClaw.NET 的 83 篇 Markdown 变成一
十一假期,我把 OpenClaw.NET 的 83 篇中文文档做成了网站。刚跑完校验脚本,屏幕上跳出 121 个死链。
我这才明白,把 Markdown 变成网站,80% 的活儿根本不在渲染,全在链接上。
仓库里连个配置文件都没有,我干脆自己写了个极简构建脚本。导航顺序直接照搬源目录里的地图,剔掉范围外的,剩下的明明白白列出来。接着写了校验器,一跑抓出 5 类 bug:首页链接写死、中文锚点没解码、正文标题重复渲染……最要命的是,源码链接脱离了仓库全成了死链。
这些站外引用我没删也没留 404,而是渲染成虚线文字,悬停显示原始路径。该指向哪还告诉你,但不假装自己能点。静态不等于简陋,我还加了全文搜索和暗色主题。
上线前我扫了一遍私钥才敢发。结果当晚源目录又变了,多了一篇新文档。第二天我重新构建,原地更新,域名还换了一个。
别急着渲染,先写校验器。让文档换个环境依然诚实,一个死链都不留。
原文把 OpenClaw.NET 的 83 篇 Markdown 变成一个网站:完整复盘
广东,2小时前,