# 这个网站是如何搭建的

> 一篇简短的版本说明：vodfetch 是如何搭建起来的，以及为什么它被设计成既供人阅读、也供机器阅读。

Source: https://vodfetch.com/zh-cn/how-this-site-is-built  ·  Free to quote and cite with attribution to 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 描述，所有这些都可被抓取、可被核查。