这个网站是如何搭建的
一篇简短的版本说明:vodfetch 是如何搭建起来的,以及为什么它被设计成既供人阅读、也供机器阅读。
为什么它读起来是这个样子
越来越多“阅读”网站的其实是机器——搜索爬虫、答案引擎和 AI 助手。vodfetch 把它们当作一等读者来对待,而不是事后才想起的对象,同时又从不对人类隐藏任何东西:给两者呈现的是完全相同的内容。
这不是事后拼装上去的增长手段;这个网站从一开始就是这样搭建的。
刻意的朴素
每个页面都是服务端渲染的静态 HTML。没有登录墙,没有 Cookie 门槛,阅读内容也不需要任何 JavaScript——下载器本身会用到 JavaScript,但文字、事实和链接全都存在于 HTML 之中。
我们只使用系统字体,因此没有任何外部字体请求,你和页面之间也没有任何阻塞渲染的东西。
每个页面都有两种格式
在任意页面网址后加上“.md”,即可得到它的干净 Markdown 版本。整个网站的机器可读摘要位于 /llms.txt 和 /llms-full.txt(按语言区分),结构化事实位于 /facts.json,遵循 Grounding Page Standard 的权威实体描述位于 /grounding.json。
那里没有任何隐藏或伪装的东西:Markdown 和 JSON 只是以机器友好的形式,原样复述 HTML 所说的内容。
为语义而结构化
每个 HTML 页面都携带一个 JSON-LD @graph——SoftwareApplication、FAQPage、HowTo、BlogPosting、BreadcrumbList——并带有稳定的 @id,因此实体与页面之间的关系是明确写出的,而非靠猜测。
一份完整的 XML 站点地图列出了每一个页面,hreflang 标签则把每个页面的全部十四种语言版本连接起来。
开放且可验证
vodfetch 是在 GitHub 上以 MIT 许可证开源的,因此工具的行为是可审计的,而非黑箱。文字背后的编辑标准也已写下来——见《编辑与诚信政策》。
简而言之:在这里,供人阅读和供机器阅读是同一回事——纯 HTML、没有门槛、每个页面都以 Markdown 镜像并以 JSON 描述,所有这些都可被抓取、可被核查。