开源社区

老冯上新:博客文档书籍翻新大作战

老冯上新:博客文档书籍翻新大作战

  • 发布:
  • 人气: 9
  • 评论: 0
标签:

应用介绍

  经常有朋友问我,之前你写的那篇XXX文章叫什么来着,想不起来了。嗨,别说你们,就连我自己有时候想搜一下之前在公众号的文章,都是有点儿费劲的。当然,这都怪公众号的搜索太垃圾,以及生态太封闭。

  所以,老冯决定专门开一个博客站点,把之前的文章都放上去。不仅可以很方便的被搜索引擎检索到,而且站内本身就有离线全文检索功能。这次选择了 Hugo + Blowfish 主题,最终成品的效果还是相当不错的。

  当然,既然干都干了,我就干脆把自己所有的开源项目文档都用 hugo 修缮了一番 (当然最大的 Pigsty 目前还是 Next.js + Fumadocs 糊的)。效果出乎意料的好,今天就来和大家分享下最终效果,以及在技术上选型与折腾的过程。

  老冯的博客站地址在: ,备案域名。目前公众号大部分的博客文章已经搬运了上去,但还有少部分遗留,过几天有空慢慢处理。这个网站有三个主要的专栏:PostgreSQL 师,数据库老司机,云计算泥石流。关注的主题是一目了然。

  PostgreSQL 师专栏,主要关注的是 PG 生态的最新进展,扩展介绍,开发经验与技巧,运维管理,架构设计,内核原理等专业内容。

  数据库老司机,关注的则是更广泛的数据库世界(PostgreSQL 除外),当然也不仅仅是数据库,操作系统,开源,AI,Agent,DBA,信创国产化,和一些通用的技术主题都会放在这里。

  云计算泥石流,关注的则是云计算领域的最新动态(主要是下云!) —— 云厂商有什么故障或者八卦,老冯的消息算是相当灵通。当然老冯也会深入聊一聊云计算这个行业的经济原理,点评一些事件或者产品。

  其他闲聊杂谈和个人博客旅游则会发在另外一个隐藏的专栏里。另外,我给一些博客用比较新的 GPT o3 配了图,看上去非常可爱,哈哈。

  另一个重要的翻新动机是我准备把这些文章翻译成英文,我有一些外国朋友看了机器翻译的中文博客,都跟我说,你应该把它们翻译成英文,丢到 HackerNews 上去,老冯深以为然,所以这次也弄了英文版。后面还可以让 Claude Code 帮我批量翻译成法德日西各种语言。

  老冯这个博客使用的 Hugo 主题是 Blowfish,河豚鱼,目前是我认为 Hugo 生态里在博客这个赛道最能打的主题了,它提供了非常丰富的功能集合。

  不过如果是书籍文档类的内容,老冯跟喜欢使用 Hextra 主题。比如下面的《DDIA》和《PG Internal》中文翻译版本。

  这个网站的地址是 ,里面提供了简体中文与繁体中文的版本,另外英文原文也提供了摘要与参考文献部分供参考。当然,仅供学习之用。

  比较有意思的是 DDIA 的第二版已经发布了一部分,所以老冯也开了一个新的分支v2来翻译第二版。不过最近有点儿忙,我准备先让 Claude Code 给我机翻一下,做个架子再慢慢打磨。

  另一个挂在老冯域名下的网站是 Capslock 改键方案。可以在 Mac 上把你的大写锁定(Capslock)键修改成一个超级强力的按键。

  关于这个项目,老冯之前写过一篇文章介绍《》,这个方案我用了快十年,不夸张的说能让作电脑的速度提高好几倍 —— 或者换种说法,当我偶尔需要在别人的电脑和键盘上进行大量键盘操作时,我感觉自己的速度慢了有六七倍。

  这个原本使用 Docsify 和 Docsy 搭建的文档站,这次也统一使用 Hextra 搭建了。

  老冯搞的 PostgreSQL 包管理器 pig 本来是蹭 Pigsty 的文档的,后来又搬运到 PG 扩展目录里蹭个位置。今天老冯一不做二不休,直接给它单开了一个域名 ,依然是 Hextra 。

  向我给这种项目添加个自带的文档站,可能只要几分钟不到。把模板里的 hugo.yml ,docs 脚手架,.github CI workflow 复制到项目里一提交,加个 DNS 解析,瞬间一个全球可访问的美观专用文档站就上线了。

  PG 扩展目录收录了 PostgreSQL 生态 423 个扩展插件的详细元数据,分类列表,下载地址与使用方式。地址: 。

  Next.js 视觉效果要比 Hugo 好,唯一的缺点就是太慢了。即使用了 Rust 写的 Turbo pack,编译一下也经常要十分钟,4c8g 的构建服务器都频繁 OOM 还要加钱。真是因为这个原因,我才把有一千多个页面的扩展目录从 Pigsty 文档站抽离出来的,不然根本都构建不动了,Hugo 就没有这个问题 ……

  最后,最大的这个 Pigsty 项目文档站,老冯还是用 Next.js + Fumadocs 框架开发的,显示效果其实比以前的 Hugo 强不少。

  当然,Next.js 的项目维护起来也比较麻烦,而且老冯觉得 MDX 文档里面各种格式控制/组件的代码噪声太大了,不利于 AI 阅读理解使用。所以可能后面还是会用 Hugo + Hextra 来改造一下。

  不过最近刚刚发布 Pigsty v3.6 ,暂时没什么时间去折腾文档换框架这档子事儿了。既来之则安之吧,反正最近赛博菩萨 Vercel 送了我大几千美元的 Credit,不用也是白不用。

  当然后来我也意识到了,写文章吧,重要的还是内容实质,框架折腾的再多,写不出来东西又有什么用呢?所以基本上上面这些方案尝试下来,最让我满意的依然是 Hugo,这个用 Go 写的静态网页生成器。

  其实 Next.js MDX 做博客也挺炫酷的,但是老冯真的撞上性能墙了,几千个页面与图片每次构建一次都慢的要死,而且考虑到 AI Agent 阅读干净无噪音的 Markdown 会更好,所以最后还是统一选择了 Hugo。PG 扩展目录和 PIGSTY 文档站目前是例外,还是用 Next.js + Fumadocs 搭建的,我觉得如果不考虑构建耗时的话,总体体验还是不错的。

  如果要我推荐的线年的当下建站,静态内容站认准 Hugo 就完事了,有无数主题可供选择 —— 但好使好看的也就那么几个,博客首选 Blowfish,备选 LoveIt,文档书籍首选 Hextra,备选 Docsy。如果非要来点儿动态效果,那么还是 Next.js 糊吧,反正现在 Claude Code 糊这个还是非常好使的。

  总的来说,老冯这次也算折腾够了,关于文档/书籍,博客的大修基本上算是完成了,后面只要持续维护就行了。如果有朋友感兴趣,后面我也可以深入聊一聊建站的一些最佳实践。

相关应用