收录内容
Crib 收录的 31 条 PostgreSQL 版本线、62 套中英文手册和 30 个 Wiki 集合,以及每部分的来源与已知缺口。
Crib 的内容分两类:PostgreSQL 手册,每条版本线一个中英双语资料包;Wiki,一个独立的双语资料包。所有内容都来自固定版本的输入,构建时记录每个文件的来源和哈希,并用 Ed25519 签名。
手册
31 条版本线,每条一套英文、一套中文,共 62 套完整手册。每条线固定到一个确切的内容版本,不跟随上游自动更新;新的小版本发布后,以新的资料包修订号加入版本目录,旧版本保留。
| 版本线 | 内容版本 | 版本线 | 内容版本 | 版本线 | 内容版本 |
|---|---|---|---|---|---|
| 6.3 | 6.3.2 | 8.2 | 8.2.23 | 11 | 11.22 |
| 6.4 | 6.4.2 | 8.3 | 8.3.23 | 12 | 12.22 |
| 6.5 | 6.5.3 | 8.4 | 8.4.22 | 13 | 13.23 |
| 7.0 | 7.0.3 | 9.0 | 9.0.23 | 14 | 14.24 |
| 7.1 | 7.1.3 | 9.1 | 9.1.24 | 15 | 15.19 |
| 7.2 | 7.2.8 | 9.2 | 9.2.24 | 16 | 16.15 |
| 7.3 | 7.3.21 | 9.3 | 9.3.25 | 17 | 17.11 |
| 7.4 | 7.4.30 | 9.4 | 9.4.26 | 18 | 18.6(默认) |
| 8.0 | 8.0.26 | 9.5 | 9.5.25 | 19 | 19rc1(预览版) |
| 8.1 | 8.1.23 | 9.6 | 9.6.24 | 20 | 20devel(开发快照) |
| 10 | 10.23 |
19 和 20 不是正式版
19 固定为 19rc1,20 是 2026-10-16 的 20devel 开发快照。它们不会成为默认版本:总别名 pg 只指向正式版。用 pg19:、pgdevel: 前缀可以单独搜索它们,见版本与别名。
来源
- 英文手册:PostgreSQL 全球开发组发布的官方文档,按上表版本从固定的源码归档构建。19 和 20 缺少现成的 HTML 构建,从固定的源码输入补建。
- 中文手册:pgdoc 收录的各版本简体中文译本。每套手册保留原有的译者署名和版权声明,例如 18.6 中文版署名“翻译:冯若航,Pigsty 项目组”。
- 历史资源:6.3、6.4 等早期中文版缺失的 CSS 和图片,只从同一版本的另一语言版本或核实过的同版材料补齐,并逐个记录来源。
规模
| 项目 | 数量 |
|---|---|
| HTML 页面 | 54,887 |
| 可检索章节 | 409,439 |
| 中英文章节对应 | 77,580 对 |
| 缺失的必需资源 | 0 |
中英文章节对应只在两侧手册源码里都能找到唯一的章节声明、且 HTML 中有唯一的物理锚点时才建立;标题相同或自动生成的 ID 不算数。没有对应的章节,切换语言时回到最近的已对应父节,并明确提示。
已知缺口
- 原始手册中有 80 处历史失效链接和 235 处重复锚点,Crib 保留原样并在资料包审计中列出,不臆造目标。
- 本地 SVG 插图(PG 12–20 中的 GIN、页面布局、GEQO 等图)以静态图片显示,脚本与远程资源一律去除。
Wiki
Wiki 来自 pg.center 2026-10-24 的冻结快照,打成一个独立的双语资料包。它把散落在手册各处的对象整理成条目:一个配置参数、一个函数、一个等待事件各是一条,带类型、默认值、出现版本和来源。导航分六组共 30 个集合:
| 分组 | 集合 |
|---|---|
| 查询语言 | SQL 命令、数据类型、函数、运算符、SQLSTATE |
| 索引与存储 | 系统目录、索引访问方法、表访问方法、操作符族、存储参数、存储结构、OID 类型 |
| 运行与诊断 | 配置参数、执行计划、等待事件、锁、统计与指标、认证方法、预定义角色 |
| 客户端与协议 | psql 命令、命令行工具、连接参数、协议消息 |
| 扩展机制 | 外部数据包装器、扩展钩子、过程语言、全文检索组件、排序规则与编码、逻辑解码插件 |
| 版本 | 版本(汇总各版本的发布、安全公告与能力信息) |
前五组是 29 种实体集合;“版本”是组合视图,把版本发布、CVE 与能力矩阵放在一起看。
| 项目 | 数量 |
|---|---|
| 文档 | 12,143 |
| 章节 | 212,257 |
| 事实记录 | 459,513 |
| 原始对象 | 10,087 |
Wiki 的边界
- 不是每个集合在每个版本、每种语言都有覆盖。部分扩展集合只覆盖 PG 10–20,表访问方法从 PG 12 开始。
- “未观测到”和“已移除”是两回事。只有来源明确写出时才标记某项被移除,覆盖缺口不会被当成删除。
- 每条事实显示来源、版本和观测时间;某种语言没有正文时显示缺失,不用另一种语言填充。
- Wiki 中引用的外部网页和插图不随包下载。
你自己的资料
笔记、书签、标签、阅读历史、本地更正和片段不属于任何资料包,单独存放在用户目录里。卸载或更新文档版本不会删除它们。见笔记、书签与本地更正和用户数据与迁移。