文档
17 篇为什么要做 PostgreSQL 汉化?

PostgreSQL 19 的发布时间表定了:RC1 在下周四(10 月 15 日),不出意外的话,正式版在 10 月 29 日发布。 借这个节点,老冯报告一个和中文用户直接相关的好消息:继简体中文之后,繁体中文的消息本地化也进了 PG 19。从这个版本开始,PostgreSQL 会同时说一口完整的简体中文和繁体中文。 简体中文支持之前已经聊过,今天再聊聊为什么要做这件事。 简繁中文,全部达标 回顾一下:前阵子老冯给 PG 上游提交的简体中文(zh_CN)消息翻译,已经随 19 Beta 4 发 …
PostgreSQL 19 的发布时间表定了:RC1 在下周四(10 月 15 日),不出意外的话,正式版在 10 月 29 日发布。 借这个节点,老冯报告一个和中文用户直接相关的好消息:继简体中文之后,繁体中文的消息本地化也进了 PG 19。从这个版本开始,PostgreSQL 会同时说一口完整的简体中文和繁体中文。 简体中文支持之前已经聊过,今天再聊聊为什么要做这件事。 简繁中文,全部达标 回顾一下:前阵子老冯给 PG 上游提交的简体中文(zh_CN)消息翻译,已经随 19 Beta 4 发 …
PG 中文文档发布:11 个大版本,一个不落

今日 pgsql.cc 上线,包含 11 个 PG 大版本的中文文档、美化后的官网,以及更好的全文检索,彻底补上了 PostgreSQL 中文生态的文档短板。 不只是手册。整个 postgresql.org 官网——首页、关于、新闻、活动、下载、社区、开发者、支持——全部汉化。顺手还把官网的样式重做了一遍,把那个饱受诟病的全文检索也换掉了。 先说这份文档 在线的中文手册一共覆盖 11 个大版本:从 PG 10 一路到 PG 19 Beta,外加一个 PG 20 devel 的开发快照。 本来我没 …
今日 pgsql.cc 上线,包含 11 个 PG 大版本的中文文档、美化后的官网,以及更好的全文检索,彻底补上了 PostgreSQL 中文生态的文档短板。 不只是手册。整个 postgresql.org 官网——首页、关于、新闻、活动、下载、社区、开发者、支持——全部汉化。顺手还把官网的样式重做了一遍,把那个饱受诟病的全文检索也换掉了。 先说这份文档 在线的中文手册一共覆盖 11 个大版本:从 PG 10 一路到 PG 19 Beta,外加一个 PG 20 devel 的开发快照。 本来我没 …
文档驱动:AI 软件工程的第一秘籍

文档不是代码写完以后的补充,而是写代码之前的输入、开发过程中的工作记忆,以及交付时的验收标准。 前几天写了《AGI 机关枪发下来了》,讲我怎么一个月烧掉十几个 AI 订阅,把手头一堆项目全推了一遍。后台和评论区问得最多的,不是“哪个模型好用”,而是:这么多 AI 写出来的代码,你怎么保证它不是屎山? 这问题问得对。机关枪发下来,人人都能突突;但代码写得快,不等于软件做得好,更不等于半年以后还能维护。所以今天就来聊聊我这几个月用 AI 做工程的路数和心得。 核心总共四条:文档驱动、对抗审查、暴力 …
文档不是代码写完以后的补充,而是写代码之前的输入、开发过程中的工作记忆,以及交付时的验收标准。 前几天写了《AGI 机关枪发下来了》,讲我怎么一个月烧掉十几个 AI 订阅,把手头一堆项目全推了一遍。后台和评论区问得最多的,不是“哪个模型好用”,而是:这么多 AI 写出来的代码,你怎么保证它不是屎山? 这问题问得对。机关枪发下来,人人都能突突;但代码写得快,不等于软件做得好,更不等于半年以后还能维护。所以今天就来聊聊我这几个月用 AI 做工程的路数和心得。 核心总共四条:文档驱动、对抗审查、暴力 …
Oink:用 Markdown 快速创建美观的现代网站

十几天前,我只是想给几个新项目找一套顺眼的文档主题。 十几天后,我把自己的 18 个网站全部迁了过去。 从 Pigsty 的中英文文档、Silo、PIG、SOW、PG Exporter,到公司首页、个人博客,再到《设计数据密集型应用》这样的多语言书籍,现在全部运行在同一套框架上。 这可不是什么换个颜色、改个字体的小装修。十八个网站的内容结构、语言、规模和用途各不相同:有上千个页面的大型技术文档,有只有几页的小工具,有博客,有书籍,有下载站,还有纯粹用来做产品介绍的 Landing Page。 把 …
十几天前,我只是想给几个新项目找一套顺眼的文档主题。 十几天后,我把自己的 18 个网站全部迁了过去。 从 Pigsty 的中英文文档、Silo、PIG、SOW、PG Exporter,到公司首页、个人博客,再到《设计数据密集型应用》这样的多语言书籍,现在全部运行在同一套框架上。 这可不是什么换个颜色、改个字体的小装修。十八个网站的内容结构、语言、规模和用途各不相同:有上千个页面的大型技术文档,有只有几页的小工具,有博客,有书籍,有下载站,还有纯粹用来做产品介绍的 Landing Page。 把 …
OINK:文档框架这件事,折腾了六年,终于靠 Codex 毕业了

做一个文档网站并不难,难的是让它五年之后依然好用。 最初,你只想把几份 Markdown 放到网上。 后来,需求开始自己生长:全文检索、深色模式、多语言、多版本、API 文档、流程图、终端录像、移动端适配、SEO、RSS、评论、访问统计、打印导出…… 再往后抬头一看,你已经在维护一套前端工程了:Node.js、npm、PostCSS、几十个依赖包,还有一堆不知道哪天会失效的 CDN 链接。 文档本来是用来降低项目维护成本的,最后自己却变成了一个需要维护的项目。 这就是我做 Oink 的原因。 …
做一个文档网站并不难,难的是让它五年之后依然好用。 最初,你只想把几份 Markdown 放到网上。 后来,需求开始自己生长:全文检索、深色模式、多语言、多版本、API 文档、流程图、终端录像、移动端适配、SEO、RSS、评论、访问统计、打印导出…… 再往后抬头一看,你已经在维护一套前端工程了:Node.js、npm、PostCSS、几十个依赖包,还有一堆不知道哪天会失效的 CDN 链接。 文档本来是用来降低项目维护成本的,最后自己却变成了一个需要维护的项目。 这就是我做 Oink 的原因。 …
让 AI 证明「吃大蒜能防中耳炎」

上个月我的老朋友马工在群里喷我,天天用 ChatGPT 写一些看起来很高大上,实际上没有实践支撑的意林风小哲理。 他认为:「你随便捏一个理论,比如说人吃大蒜中耳炎发病概率就会降低,Claude 都能从历史上找个什么心理学家社会学家哲学家给你背书。」我当时觉得这个实验很有趣,就真的试一下。 结果比我预期的要可怕得多。 · · · 实验:给一个荒谬命题找学术背书 我给 AI 的指令非常直白:去捏一个理论,来论证人吃大蒜中耳炎的发病概率会降低。 几十秒之后,我收到了一篇格式完美的“综述论文”。引用了 …
上个月我的老朋友马工在群里喷我,天天用 ChatGPT 写一些看起来很高大上,实际上没有实践支撑的意林风小哲理。 他认为:「你随便捏一个理论,比如说人吃大蒜中耳炎发病概率就会降低,Claude 都能从历史上找个什么心理学家社会学家哲学家给你背书。」我当时觉得这个实验很有趣,就真的试一下。 结果比我预期的要可怕得多。 · · · 实验:给一个荒谬命题找学术背书 我给 AI 的指令非常直白:去捏一个理论,来论证人吃大蒜中耳炎的发病概率会降低。 几十秒之后,我收到了一篇格式完美的“综述论文”。引用了 …
是的,我用 AI 写文章

老冯公众号文章下面,经常有人留言几个字:“AI 写的”。 对,我用 AI,而且用得很深。老冯不觉得这有什么需要遮掩的。 但我觉得这个话题本身值得认真聊一次 —— 一个人到底该怎么用 AI 来创作,以及“AI 写的”这个评价到底意味着什么。 我怎么用 AI 写文章 先讲一遍老冯写文章的流程,您自己判断,这算不算“AI 写的”。 选题是我的。 我每天在各个领域有大量阅读、思考和交流。很多主题我都会与 Claude 进行探讨。有时候,一些交流的对话让我感觉值得记录和分享,就会尝试将它转换成一篇文章,这 …
老冯公众号文章下面,经常有人留言几个字:“AI 写的”。 对,我用 AI,而且用得很深。老冯不觉得这有什么需要遮掩的。 但我觉得这个话题本身值得认真聊一次 —— 一个人到底该怎么用 AI 来创作,以及“AI 写的”这个评价到底意味着什么。 我怎么用 AI 写文章 先讲一遍老冯写文章的流程,您自己判断,这算不算“AI 写的”。 选题是我的。 我每天在各个领域有大量阅读、思考和交流。很多主题我都会与 Claude 进行探讨。有时候,一些交流的对话让我感觉值得记录和分享,就会尝试将它转换成一篇文章,这 …
PG 五大版本中文文档已就绪,欢迎查阅!

昨天,老冯发布了 PostgreSQL 官网的中文镜像站 PG.center。一经上线,就感受到了广大用户的热情。不过在昨天刚发布的时候,站上还只有 PG 18 的中文文档。虽然 PG 17、16、15、14 这四个大版本也都仍在生命周期内,但我之前偷了个懒,先拿英文版顶了一下。 今天我的 Codex 配额刷新了,所以我又“烧掉”了这一周的额度,把剩下这几个大版本的文档全部翻译成了中文。现在,PG 生命周期内的五个大版本中文文档,已经全部正式发布了! PostgreSQL 18 中文文档(当前最 …
昨天,老冯发布了 PostgreSQL 官网的中文镜像站 PG.center。一经上线,就感受到了广大用户的热情。不过在昨天刚发布的时候,站上还只有 PG 18 的中文文档。虽然 PG 17、16、15、14 这四个大版本也都仍在生命周期内,但我之前偷了个懒,先拿英文版顶了一下。 今天我的 Codex 配额刷新了,所以我又“烧掉”了这一周的额度,把剩下这几个大版本的文档全部翻译成了中文。现在,PG 生命周期内的五个大版本中文文档,已经全部正式发布了! PostgreSQL 18 中文文档(当前最 …
PostgreSQL 官网中文版:pg.center

用 PostgreSQL 这么多年,有一件事一直让我觉得遗憾:postgresql.org 官网一直没有中文版。 作为世界上最先进的开源数据库,PostgreSQL 的官方网站承载着项目介绍、版本发布、官方文档、社区活动、开发者资源等核心信息。对于英文用户来说,这是一站式的信息中枢;但对于国内广大的 PG 用户而言,语言门槛始终横亘在那里。 所以我做了一件事:把 postgresql.org 整个 fork 了一份中文版。 域名是:pg.center。 包括当下缺失的 PG 18 中文文档,也随 …
用 PostgreSQL 这么多年,有一件事一直让我觉得遗憾:postgresql.org 官网一直没有中文版。 作为世界上最先进的开源数据库,PostgreSQL 的官方网站承载着项目介绍、版本发布、官方文档、社区活动、开发者资源等核心信息。对于英文用户来说,这是一站式的信息中枢;但对于国内广大的 PG 用户而言,语言门槛始终横亘在那里。 所以我做了一件事:把 postgresql.org 整个 fork 了一份中文版。 域名是:pg.center。 包括当下缺失的 PG 18 中文文档,也随 …
464个扩展开箱即用:新版 PG 扩展目录发布

今天老冯又让 Claude Code 干了一件大好事 —— 做了一个全新的 PostgreSQL 扩展目录。就放在 https://pigsty.cc/ext 这里。 说起来,这已经是第五版了。兜兜转转一大圈,又回到了第一版使用的 Hugo + Docsy 框架,重新融合到 Pigsty 主站。这个过程本身就是个故事,后面再聊。先说说这一版到底做了什么。 不只是有包,还要有文档 之前的扩展目录,核心功能是告诉你:这个扩展叫什么、元数据在哪里、二进制包怎么下载、一键安装怎么搞。你装好了就行,至于怎 …
今天老冯又让 Claude Code 干了一件大好事 —— 做了一个全新的 PostgreSQL 扩展目录。就放在 https://pigsty.cc/ext 这里。 说起来,这已经是第五版了。兜兜转转一大圈,又回到了第一版使用的 Hugo + Docsy 框架,重新融合到 Pigsty 主站。这个过程本身就是个故事,后面再聊。先说说这一版到底做了什么。 不只是有包,还要有文档 之前的扩展目录,核心功能是告诉你:这个扩展叫什么、元数据在哪里、二进制包怎么下载、一键安装怎么搞。你装好了就行,至于怎 …
一天翻译完 PG 生态三大件文档

最近 Pigsty v4.2 刚发布完,手头空了下来。正好一看,这周的 Claude Token 额度快到期了,不用也是白扔。一时心痒,得找个活儿把它挥霍掉。 想了想,去翻译文档吧。 于是我花了一天时间,把 PgBouncer 连接池、pgBackRest 备份工具、Patroni 高可用模板 这三个 PostgreSQL 生态中最重要的开源组件文档,全部翻译成了中文。顺手还把 PostgreSQL 18.3 的官方文档也过了一遍——虽然还在校对中,但主体已经出来了。 干完之后我自己都有点恍惚: …
最近 Pigsty v4.2 刚发布完,手头空了下来。正好一看,这周的 Claude Token 额度快到期了,不用也是白扔。一时心痒,得找个活儿把它挥霍掉。 想了想,去翻译文档吧。 于是我花了一天时间,把 PgBouncer 连接池、pgBackRest 备份工具、Patroni 高可用模板 这三个 PostgreSQL 生态中最重要的开源组件文档,全部翻译成了中文。顺手还把 PostgreSQL 18.3 的官方文档也过了一遍——虽然还在校对中,但主体已经出来了。 干完之后我自己都有点恍惚: …
如何快速上手学习 PostgreSQL?

老冯最近多次被人问到一个问题:“如何上手学习 PostgreSQL”?已经不是一次两次了,所以感觉有必要写个教程集体回答一下。 老冯认为,学习 PostgreSQL 的最好方式就是 Learn by doing —— 通过实践来学习,而不是通过死看书,报什么培训班之类的东西。 现在的学习条件要比以前好太多了,因为每个人都可以有一个非常耐心的高水平老师在身边随时指导 —— 有什么问题直接问 AI 就是了。 不过俗话说:“师傅领进门,修行在个人”。即使有 AI 助力,起步的那个入门过程依然是最难的, …
老冯最近多次被人问到一个问题:“如何上手学习 PostgreSQL”?已经不是一次两次了,所以感觉有必要写个教程集体回答一下。 老冯认为,学习 PostgreSQL 的最好方式就是 Learn by doing —— 通过实践来学习,而不是通过死看书,报什么培训班之类的东西。 现在的学习条件要比以前好太多了,因为每个人都可以有一个非常耐心的高水平老师在身边随时指导 —— 有什么问题直接问 AI 就是了。 不过俗话说:“师傅领进门,修行在个人”。即使有 AI 助力,起步的那个入门过程依然是最难的, …
新坑:PostgreSQL 36计

今天老冯起了一个新坑 —— PG 36 计。这是一套关于 PostgreSQL 应用开发与运维管理的教程。今天刚刚把架子搭好,准备在后面不断填充内容。 说起这个企划,这本书还是当初 2017 年翻译完 DDIA 第一版后,我想搞的一个系列,PostgreSQL 教程,分应用,管理,内核三篇。昨天刚把 DDIA 第二版的 Claude 机翻给弄好,一下子就想到了这本书,这本书就连目录结构都是照着 DDIA 弄的,原来的版本目录如下: 当初还有两家出版社来找,怂恿我写一本。不过那时候老冯确实比较忙, …
今天老冯起了一个新坑 —— PG 36 计。这是一套关于 PostgreSQL 应用开发与运维管理的教程。今天刚刚把架子搭好,准备在后面不断填充内容。 说起这个企划,这本书还是当初 2017 年翻译完 DDIA 第一版后,我想搞的一个系列,PostgreSQL 教程,分应用,管理,内核三篇。昨天刚把 DDIA 第二版的 Claude 机翻给弄好,一下子就想到了这本书,这本书就连目录结构都是照着 DDIA 弄的,原来的版本目录如下: 当初还有两家出版社来找,怂恿我写一本。不过那时候老冯确实比较忙, …
老冯上新:博客文档书籍翻新大作战

经常有朋友问我,之前你写的那篇 XXX 文章叫什么来着,想不起来了。嗨,别说你们,就连我自己有时候想搜一下之前在公众号的文章,都是有点儿费劲的。当然,这都怪公众号的搜索太垃圾,以及生态太封闭。 所以,老冯决定专门开一个博客站点,把之前的文章都放上去。不仅可以很方便的被搜索引擎检索到,而且站内本身就有离线全文检索功能。这次选择了 Hugo + Blowfish 主题,最终成品的效果还是相当不错的。 当然,既然干都干了,我就干脆把自己所有的开源项目文档都用 hugo 修缮了一番 (当然最大的 …
经常有朋友问我,之前你写的那篇 XXX 文章叫什么来着,想不起来了。嗨,别说你们,就连我自己有时候想搜一下之前在公众号的文章,都是有点儿费劲的。当然,这都怪公众号的搜索太垃圾,以及生态太封闭。 所以,老冯决定专门开一个博客站点,把之前的文章都放上去。不仅可以很方便的被搜索引擎检索到,而且站内本身就有离线全文检索功能。这次选择了 Hugo + Blowfish 主题,最终成品的效果还是相当不错的。 当然,既然干都干了,我就干脆把自己所有的开源项目文档都用 hugo 修缮了一番 (当然最大的 …
计算机名著《DDIA》野猪书第二版来了

《设计数据密集型应用》(DDIA)作为一本公认的计算机/互联网名著,终于在在时隔七年后再版,现在处于前瞻预览阶段。目前已经放出了前三章的预览。 作为 FAANG 面试必备敲门砖,大厂入职必修课的 DDIA,我相信野猪书的大名已经在程序员中如雷贯耳,无需多言。 今天一个上午把这三章一口气读完,确实新增了许多内容,反应了这几年的新趋势,值得一看,强烈推荐。例如,第二版的第一章就完全是全新内容,提出了许多极富洞见的问题: DDIA 第一版出来时,我在 GitHub 上拉起了一个开源项目,提供了一个学习 …
《设计数据密集型应用》(DDIA)作为一本公认的计算机/互联网名著,终于在在时隔七年后再版,现在处于前瞻预览阶段。目前已经放出了前三章的预览。 作为 FAANG 面试必备敲门砖,大厂入职必修课的 DDIA,我相信野猪书的大名已经在程序员中如雷贯耳,无需多言。 今天一个上午把这三章一口气读完,确实新增了许多内容,反应了这几年的新趋势,值得一看,强烈推荐。例如,第二版的第一章就完全是全新内容,提出了许多极富洞见的问题: DDIA 第一版出来时,我在 GitHub 上拉起了一个开源项目,提供了一个学习 …
快速掌握PostgreSQL版本新特性

最近朋友新出了一本书,书名朴实无华简单直接:《快速掌握 PostgreSQL 版本新特性》。内容是详细介绍了 PostgreSQL 最近 7 个大版本的新特性。我收到了一本样书,浏览了一遍之后,感觉写的确实不错,所以推荐给大家。 这本书的组织结构很简单,就是每个大版本对应一章,从 PG10 开始,到 2023 年刚发布的 PG 16 结束。每一章按照性能、可靠性、运维管理、开发易用性、系统架构五个大方向对特性进行逐一介绍与梳理,一目了然。\ PostgreSQL 文档与 ReleaseNote …
最近朋友新出了一本书,书名朴实无华简单直接:《快速掌握 PostgreSQL 版本新特性》。内容是详细介绍了 PostgreSQL 最近 7 个大版本的新特性。我收到了一本样书,浏览了一遍之后,感觉写的确实不错,所以推荐给大家。 这本书的组织结构很简单,就是每个大版本对应一章,从 PG10 开始,到 2023 年刚发布的 PG 16 结束。每一章按照性能、可靠性、运维管理、开发易用性、系统架构五个大方向对特性进行逐一介绍与梳理,一目了然。\ PostgreSQL 文档与 ReleaseNote …
Pigsty官方网站上线啦!

好久没有冒泡了!今天,俺很荣幸的宣布,Pigsty 官方文档站上线啦! 地址为:http://pigsty.cc\ 什么?你问 Pigsty 是什么东东?\ Pigsty 是我亲自开发的 PostgreSQL 监控系统暨高可用数据库供给方案。 开源免费!详见下图,或者您点进那个站点看看也行啊。\ 虽然 “世界上最好的 PostgreSQL 监控系统”这个口号好像有违反广告法的嫌疑,不过自己站在甲方爸爸的立场上,我也确实找不到比它更好的了。用真理说服人嘛,所以也就厚着脸皮这样写上了,反正我也没收钱 …
好久没有冒泡了!今天,俺很荣幸的宣布,Pigsty 官方文档站上线啦! 地址为:http://pigsty.cc\ 什么?你问 Pigsty 是什么东东?\ Pigsty 是我亲自开发的 PostgreSQL 监控系统暨高可用数据库供给方案。 开源免费!详见下图,或者您点进那个站点看看也行啊。\ 虽然 “世界上最好的 PostgreSQL 监控系统”这个口号好像有违反广告法的嫌疑,不过自己站在甲方爸爸的立场上,我也确实找不到比它更好的了。用真理说服人嘛,所以也就厚着脸皮这样写上了,反正我也没收钱 …