Ruohang Feng:PostgreSQL 中文文档上线:全部 11 个主要版本

Ruohang Feng:PostgreSQL 中文文档上线:全部 11 个主要版本

💡 原文英文,约1700词,阅读约需6分钟。
📝

内容提要

Pigsty 团队推出 pgsql.cc,提供 PostgreSQL 10 至 20 共 11 个主要版本的中文文档,并汉化官网首页、新闻、下载等板块,重做样式与全文搜索。此前社区翻译止步于 15,机器翻译版本缺乏维护。作者借助 AI 与术语表完成翻译,保证跨版本一致性,并将持续跟进上游更新。网站无广告,与 PGDG 无关,采用相同开源许可。

🔎

延伸解读

为什么覆盖已停止维护的旧版本

文章指出,尽管 PG 10 至 12 等版本已结束生命周期,但国内仍有大量系统在运行这些版本,且升级计划可能推迟到明年。如果中文文档只覆盖受支持版本,这些用户仍要面对英文手册。因此,将翻译范围回溯到 10 是出于实际使用需求,而非单纯追求版本数量。

跨版本翻译一致性的挑战

11 个主要版本共享大量相同内容,但同一英文句子在不同版本中的中文翻译必须完全一致,否则读者切换版本时会感到困惑。作者为此建立了术语表和例外清单,并用多个模型交叉校验,再人工修订,以确保 PG 14 至 18 等版本间的表述统一。

与机器翻译站点的关键差异

文章提到,此前出现的 18.3 中文翻译疑似机器翻译且无人维护,上游发布 18.6 等小版本后也未更新。而 pgsql.cc 承诺持续跟进上游更新,包括小版本发布和 19 正式版,并欢迎用户通过邮件或 GitHub issue 反馈错误,修复迅速。

网站改进与使用便利性

除了文档翻译,网站还汉化了官网首页、新闻、下载等板块,重做了样式和全文搜索。用户可通过替换域名访问对应中文页面,每页右上角可一键返回英文原版对照。此外,Patroni、PgBouncer 等生态组件的中文文档也已就绪,方便集中查阅。

Q&A

pgsql.cc 提供了哪些 PostgreSQL 版本的中文文档?

pgsql.cc 提供了 PostgreSQL 10 到 20 共 11 个主要版本的中文文档,包括 PG 10 至 PG 19 Beta 以及 PG 20 devel 快照。

为什么 pgsql.cc 要翻译已经停止维护的 PostgreSQL 版本(如 10、11、12)?

因为国内仍有大量系统在使用这些旧版本,例如 PG 11 或 PG 12,且升级计划可能安排在明年,如果文档只覆盖受支持版本,这些用户仍需要阅读英文文档。

pgsql.cc 的翻译是如何保证跨版本一致性的?

通过建立权威的 PostgreSQL 术语表和例外列表,确保相同英文句子在所有版本中翻译一致,并利用 AI 模型交叉检查术语,最后人工审核,使所有主要版本的翻译保持对齐。

pgsql.cc 除了文档翻译,还对 PostgreSQL 官网做了哪些改进?

pgsql.cc 汉化了官网首页、关于、新闻、活动、下载、社区、开发者和支持等板块,重新设计了样式和中文排版,并改进了全文搜索功能,支持直接搜索文档和扩展,按 / 键即可打开搜索。

pgsql.cc 和 PGDG 有什么关系?网站有广告吗?

pgsql.cc 由 Pigsty 团队维护,与 PGDG 无关,网站明确声明了这一点。网站没有广告,最多在角落有一个文字链接说明由 Pigsty 团队维护。

pgsql.cc 的域名为什么从 pg.center 更换为 pgsql.cc?

因为 .center 域名不符合中国工信部的备案要求,无法在中国大陆进行 ICP 备案,而 pgsql.cc 可以备案,且域名含义清晰:PGSQL + CC 代表中国/中文社区。

🏷️

标签

➡️

继续阅读