关于
冯若航（@Vonng）做 Pigsty —— 一个 PostgreSQL 发行版，以及 OINK ——负责出版它文档的 Hugo 主题。两者出自同一个问题： 把数据库跑好，和把「怎么跑好」讲清楚，是同一套知识；而且这套知识写砸了就等于没有。
OINK 的起因是这一家子的十三个站点已经漂成了同一套主题的十三份拷贝。它是 Docsy 的硬分叉，保留 Docsy 的内容模型，换掉外壳、导航、 检索、内容原语与排版体系——全程只有一条规矩：需要 CDN、需要 npm install、 或者需要一个读者从未选择过的公共服务的功能，不发。
别处
- vonng.com — 长文
- GitHub 上的 @Vonng — 这些站点背后的仓库
- pgsty.com — 这些工作所属的公司
-
在 Blog 外壳上沉浸式阅读
本页仍然由普通 Blog 外壳渲染，背后没有特殊的内容类型。只需四个 front matter 键 就能改变呈现；一个分区也可以在 cascade 里一次写下同样的配方： featured_image: hero # 题图成为全幅开场 toc_style: flow # 更宽的大纲从正文起点开始 toc_taxonomies: false # 右栏只保留大纲 sidebar_enabled: false Hero 开场 带有题图的页面可以用它开场。hero 会把图片变成横跨视口顶部的背景， 将标 …
本页仍然由普通 Blog 外壳渲染，背后没有特殊的内容类型。只需四个 front matter 键 就能改变呈现；一个分区也可以在 cascade 里一次写下同样的配方： featured_image: hero # 题图成为全幅开场 toc_style: flow # 更宽的大纲从正文起点开始 toc_taxonomies: false # 右栏只保留大纲 sidebar_enabled: false Hero 开场 带有题图的页面可以用它开场。hero 会把图片变成横跨视口顶部的背景， 将标 …
-
OINK 实现预览正式亮相
今天，我们发布 OINK 实现预览：它从 Docsy 直接演化而来，提供唯一标准产品外壳、仅依赖 Hugo 的消费端构建、本地优先浏览器依赖、通用多语言框架，以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这是实现与文档里程碑，不是已经公开的版本化发行。最终公开品牌、模块与软件包身份、首个版本，以及生产 Cloudflare Pages 部署，仍是必须显式关闭的发布关卡。 为什么需要 OINK？ 多个成熟文档站分别复制了相同的 Docsy 布局、导航、搜索代码 …
今天，我们发布 OINK 实现预览：它从 Docsy 直接演化而来，提供唯一标准产品外壳、仅依赖 Hugo 的消费端构建、本地优先浏览器依赖、通用多语言框架，以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这是实现与文档里程碑，不是已经公开的版本化发行。最终公开品牌、模块与软件包身份、首个版本，以及生产 Cloudflare Pages 部署，仍是必须显式关闭的发布关卡。 为什么需要 OINK？ 多个成熟文档站分别复制了相同的 Docsy 布局、导航、搜索代码 …
-
OINK 实施日记：从复制外壳到统一主题
OINK 始于一个令人不安的事实：多个生产文档站之所以看起来相互关联，是因为它们确实源于同一套实现；但公共实现却以复制文件的形式散落在各处。呈现效果足够一致，维护模型却并非如此。 这篇日记记录项目如何从重复站点覆盖项走向一款直接演化的统一主题。它关注决策与证据，而不是逐条复述提交历史。 锁定产品契约 第一项真正有价值的工作是做减法。选择实现方式之前，我们先写清产品必须是什么： 从 Docsy 直接演化而来的独立主题； 唯一标准外壳，而不是可切换皮肤； Hugo Extended 是消费端唯一构建 …
OINK 始于一个令人不安的事实：多个生产文档站之所以看起来相互关联，是因为它们确实源于同一套实现；但公共实现却以复制文件的形式散落在各处。呈现效果足够一致，维护模型却并非如此。 这篇日记记录项目如何从重复站点覆盖项走向一款直接演化的统一主题。它关注决策与证据，而不是逐条复述提交历史。 锁定产品契约 第一项真正有价值的工作是做减法。选择实现方式之前，我们先写清产品必须是什么： 从 Docsy 直接演化而来的独立主题； 唯一标准外壳，而不是可切换皮肤； Hugo Extended 是消费端唯一构建 …