# 老冯上新：博客文档书籍翻新大作战
LLMS 索引： [llms.txt](/llms.txt)
---
经常有朋友问我，之前你写的那篇XXX文章叫什么来着，想不起来了。嗨，别说你们，就连我自己有时候想搜一下之前在公众号的文章，都是有点儿费劲的。当然，这都怪公众号的搜索太垃圾，以及生态太封闭。
所以，老冯决定专门开一个博客站点，把之前的文章都放上去。不仅可以很方便的被搜索引擎检索到，而且站内本身就有离线全文检索功能。这次选择了 Hugo + Blowfish 主题，最终成品的效果还是相当不错的。
当然，既然干都干了，我就干脆把自己所有的开源项目文档都用 hugo 修缮了一番 （当然最大的 Pigsty 目前还是 Next.js + Fumadocs 糊的）。效果出乎意料的好，今天就来和大家分享下最终效果，以及在技术上选型与折腾的过程。
## 博客站
老冯的博客站地址在： https://blog.vonng.com[1] ，备案域名。目前公众号大部分的博客文章已经搬运了上去，但还有少部分遗留，过几天有空慢慢处理。这个网站有三个主要的专栏：PostgreSQL 大法师，数据库老司机，云计算泥石流。关注的主题是一目了然。
PostgreSQL 大法师专栏，主要关注的是 PG 生态的最新进展，扩展介绍，开发经验与技巧，运维管理，架构设计，内核原理等专业内容。
数据库老司机，关注的则是更广泛的数据库世界（PostgreSQL 除外），当然也不仅仅是数据库，操作系统，开源，AI，Agent，DBA，信创国产化，和一些通用的技术主题都会放在这里。
云计算泥石流，关注的则是云计算领域的最新动态（主要是下云！） —— 云厂商有什么故障或者八卦，老冯的消息算是相当灵通。当然老冯也会深入聊一聊云计算这个行业的经济原理，点评一些事件或者产品。
其他闲聊杂谈和个人博客旅游则会发在另外一个隐藏的专栏里。另外，我给一些博客用比较新的 GPT o3 配了图，看上去非常可爱，哈哈。
另一个重要的翻新动机是我准备把这些文章翻译成英文，我有一些外国朋友看了机器翻译的中文博客，都跟我说，你应该把它们翻译成英文，丢到 HackerNews 上去，老冯深以为然，所以这次也弄了英文版。后面还可以让 Claude Code 帮我批量翻译成法德日西各种语言。
老冯这个博客使用的 Hugo 主题是 Blowfish，河豚鱼，目前是我认为 Hugo 生态里在博客这个赛道最能打的主题了，它提供了非常丰富的功能集合。
不过如果是书籍文档类的内容，老冯跟喜欢使用 Hextra 主题。比如下面的《DDIA》和《PG Internal》中文翻译版本。
## DDIA
当然，进行改造的不仅仅是博客，还有老冯以前翻译的一本互联网经典名著《设计数据密集型应用》。
这个网站的地址是 https://ddia.vonng.com[2] ，里面提供了简体中文与繁体中文的版本，另外英文原文也提供了摘要与参考文献部分供参考。当然，仅供学习之用。
比较有意思的是 DDIA 的第二版已经发布了一部分，所以老冯也开了一个新的分支 `v2` 来翻译第二版。不过最近有点儿忙，我准备先让 Claude Code 给我机翻一下，做个架子再慢慢打磨。
## PG INTERNAL
另一本书是 PG INTERNAL，也就是《PostgreSQL 技术内幕》，这本书是关于 PostgreSQL 内核原理介绍的。地址在 https://pgint.vonng.com[3] 。
Hextra 自带的 KaTeX 还挺不错的，内联 LaTeX 公式渲染的都还不错。
## Capslock 强化改造
另一个挂在老冯域名下的网站是 Capslock 改键方案。可以在 Mac 上把你的大写锁定（Capslock）键修改成一个超级强力的按键。
地址在 https://capslock.vonng.com[4] 。
关于这个项目，老冯之前写过一篇文章介绍《[用Capslock重新定义键盘](/misc/capslock/)》，这个方案我用了快十年，不夸张的说能让我操作电脑的速度提高好几倍 —— 或者换种说法，当我偶尔需要在别人的电脑和键盘上进行大量键盘操作时，我感觉自己的速度慢了有六七倍。
这个原本使用 Docsify 和 Docsy 搭建的文档站，这次也统一使用 Hextra 搭建了。
## PIG 包管理器
老冯搞的 PostgreSQL 包管理器 pig 本来是蹭 Pigsty 的文档的，后来又搬运到 PG 扩展目录里蹭个位置。今天老冯一不做二不休，直接给它单开了一个域名 https://pig.pgsty.com[5] ，依然是 Hextra 。
向我给这种项目添加个自带的文档站，可能只要几分钟不到。把模板里的 hugo.yml ，docs 脚手架，.github CI workflow 复制到项目里一提交，加个 DNS 解析，瞬间一个全球可访问的美观专用文档站就上线了。
## PG 扩展目录
PG 扩展目录收录了 PostgreSQL 生态 423 个扩展插件的详细元数据，分类列表，下载地址与使用方式。地址： https://ext.pgsty.com[6] 。
老冯之前也是用 Docsify 和 Hugo Docsy 做的，不过这次使用 Next.js + Fumadocs 框架糊了一下，看上去效果还可以。
Next.js 视觉效果要比 Hugo 好，唯一的缺点就是太慢了。即使用了 Rust 写的 Turbo pack，编译一下也经常要十分钟，4c8g 的构建服务器都频繁 OOM 还要加钱。真是因为这个原因，我才把有一千多个页面的扩展目录从 Pigsty 文档站抽离出来的，不然根本都构建不动了，Hugo 就没有这个问题 ……
## PIGSTY 文档站
最后，最大的这个 Pigsty 项目文档站，老冯还是用 Next.js + Fumadocs 框架开发的，显示效果其实比以前的 Hugo 强不少。
https://doc.pgsty.com[7]
当然，Next.js 的项目维护起来也比较麻烦，而且老冯觉得 MDX 文档里面各种格式控制/组件的代码噪声太大了，不利于 AI 阅读理解使用。所以可能后面还是会用 Hugo + Hextra 来改造一下。
不过最近刚刚发布 Pigsty v3.6 ，暂时没什么时间去折腾文档换框架这档子事儿了。既来之则安之吧，反正最近赛博菩萨 Vercel 送了我大几千美元的 Credit，不用也是白不用。
## 选型之旅
老冯折腾博客写博客也快十多年了，当然最近两年写的比较多。我折腾过许多写文档写博客的方案，从最开始在博客园，后来自己建站，试过许多框架，Pelican，StackEditor，Editor.md + Koa / Express，Go + BlackFriday，Docsify, Hugo + Docsy, Mintlify, Quip，Wiki.js, Next.js Nextra, Fumadocs 。基本上能看上眼的框架都试了一遍，甚至还自己手搓过一两个博客框架。
当然后来我也意识到了，写文章吧，重要的还是内容实质，框架折腾的再多，写不出来东西又有什么用呢？所以基本上上面这些方案尝试下来，最让我满意的依然是 Hugo，这个用 Go 写的静态网页生成器。
其实 Next.js MDX 做博客也挺炫酷的，但是老冯真的撞上性能墙了，几千个页面与图片每次构建一次都慢的要死，而且考虑到 AI Agent 阅读干净无噪音的 Markdown 会更好，所以最后还是统一选择了 Hugo。PG 扩展目录和 PIGSTY 文档站目前是例外，还是用 Next.js + Fumadocs 搭建的，我觉得如果不考虑构建耗时的话，总体体验还是不错的。
如果要我推荐的话，2025年的当下建站，静态内容站认准 Hugo 就完事了，有无数主题可供选择 —— 但好使好看的也就那么几个，博客首选 Blowfish，备选 LoveIt，文档书籍首选 Hextra，备选 Docsy。如果非要来点儿动态效果，那么还是 Next.js 糊吧，反正现在 Claude Code 糊这个还是非常好使的。
Hugo 网站托管非常简单，在 .github/workflow 里加上一个固定的文件就可以自动 CI 了，用 Giscuss 做评论，用 GitHub Pages 做托管。如果想要更快的访问，更多域名接入，也可以用 Cloudflare Pages。 Vercel 也不仅可以托管 Next.js 项目，也可以放 Hugo 的，而且中国大陆访问速度也还行的。至于分析的话，我用的是 PostHog + Google Analytics ，也是傻瓜式一键接入就行。
总的来说，老冯这次也算折腾够了，关于文档/书籍，博客的大修基本上算是完成了，后面只要持续维护就行了。如果有朋友感兴趣，后面我也可以深入聊一聊建站的一些最佳实践。
### References
`[1]`: *https://blog.vonng.com*\
`[2]`: *https://ddia.vonng.com*\
`[3]`: *https://pgint.vonng.com*\
`[4]`: *https://capslock.vonng.com*\
`[5]`: *https://pig.pgsty.com*\
`[6]`: *https://ext.pgsty.com*\
`[7]`: *https://doc.pgsty.com*