pg12

PostgreSQL 12.2中文手册的翻译

本页面对PostgreSQL 12.2中文手册翻译的步骤和注意事项进行说明。

1) 12.2的翻译基线

12.2的中文手册基于上一版的社区中文手册《PostgreSQL 11.2 中文手册》。

即初始master分支对应于11.2中文sgml(加上部分12.2新增英文原始sgml),翻译过程中逐步将12.2相对于11.2的更新内容翻译后反馈到github仓库。

2) 12.2的翻译步骤

clone自己的git仓库

https://github.com/postgres-cn/pgdoc-cn.git

下载11.2和12.2的源码

https://ftp.postgresql.org/pub/source/v11.2/postgresql-11.2.tar.gz
https://ftp.postgresql.org/pub/source/v12.2/postgresql-12.2.tar.gz

在下面的[翻译进度]预定要翻译的sgml

在预定的sgml的翻译者栏填上自己的名字，并将翻译状态改为"翻译中"

12.2新增sgml的翻译

1. 翻译sgml
2. 使用注释自动添加工具添加注释 注释自动添加工具的使用方法，参考翻译的注意点

12.2相对11.2变更的sgml的翻译

1. 对比12.2源码中的英文原始sgml和11.2英文原始sgml找到变更点
2. 翻译变更内容并合并到github的sgml文件中
3. 更新英文原文注释(可选)
   变更少的可以手动更新。大量变更的sgml，建议通过注释自动添加工具处理。先用使用注释自动添加工具删除之前的注释，再使用注释自动添加工重新添加注释。 中文手册全部翻译后，我们会对所有sgml全部使用自动注释工具重新生成一次注释，所以翻译者也可以省略更新注释的步骤。

创建PR将翻译好的sgml提交到git仓库

github提交PR的步骤,可参考下面的例子。

• http://blog.chinaunix.net/uid-20726500-id-5150100.html

在[翻译进度]中更新sgml的状态为“完成”

3) 翻译的注意点

编辑sgml文件时，请务必事先阅读翻译的注意点。

4) 翻译进度

翻译状态:待翻译，翻译中，完成

对于github仓库中以下待翻译的初始sgml文件，修改类型为"NEW"的文件是12.2新增的原始英文sgml，其余sgml来自11.2中文sgml。

NO	修改类型	A&M	DEL	翻译状态	翻译者	sgml
1	MOD	8	0	完成	sunshinerxu	amcheck.sgml
2	MOD	44	0	完成	sunshinerxu	auto-explain.sgml
3	MOD	54	3	完成	sunshinerxu	backup.sgml
4	MOD	1	0	完成	sunshinerxu	bgworker.sgml
5	MOD	8	0	完成	sunshinerxu	biblio.sgml
6	MOD	147	9	完成	sunshinerxu	bki.sgml
7	MOD	2	0	完成	sunshinerxu	bloom.sgml
8	MOD	0	22	完成	sunshinerxu	brin.sgml
9	MOD	441	79	完成	sunshinerxu	catalogs.sgml
10	MOD	60	0	完成	sunshinerxu	charset.sgml
11	MOD	21	0	完成	chegong18	citext.sgml
12	MOD	224	0	完成	chegong18	client-auth.sgml
13	MOD	1162	50	完成	chegong18	config.sgml
14	MOD	0	93	完成	chegong18	contrib-spi.sgml
15	MOD	2	3	完成	chegong18	custom-scan.sgml
16	MOD	121	48	完成	chegong18	datatype.sgml
17	MOD	15	0	完成	chegong18	dblink.sgml
18	MOD	914	121	完成	chegong18	ddl.sgml
19	MOD	3	0	完成	chegong18	diskusage.sgml
20	MOD	4	0	完成	chegong18	docguide.sgml
21	MOD	51	0	完成	chegong18	ecpg.sgml
22	MOD	147	0	完成	chegong18	event-trigger.sgml
23	MOD	61	0	完成	chegong18	extend.sgml
24	MOD	1	0	完成	chegong18	external-projects.sgml
25	MOD	100	0	完成	chegong18	fdwhandler.sgml
26	MOD	339	0	完成	sizhitu	features.sgml
27	MOD	2	1	完成	chegong18	file-fdw.sgml
28	MOD	4	1	完成	ChenHuajun	filelist.sgml
29	MOD	1933	11	完成	sizhitu	func.sgml
30	MOD	22	0	完成	chegong18	gin.sgml
31	MOD	5	0	完成	chegong18	gist.sgml
32	MOD	50	10	完成	chegong18	high-availability.sgml
33	MOD	25	0	完成	chegong18	indexam.sgml
34	MOD	51	0	完成	chegong18	indices.sgml
35	MOD	70	0	完成	chegong18	information_schema.sgml
36	MOD	28	48	完成	chegong18	install-windows.sgml
37	MOD	38	304	完成	chegong18	installation.sgml
38	MOD	304	0	完成	chegong18	json.sgml
39	MOD	1	5345	完成	chegong18	keywords.sgml
40	MOD	184	1	完成	chegong18	libpq.sgml
41	NEW	120	0	完成	ChenHuajun	limits.sgml
42	MOD	9	0	完成	ChenHuajun	logical-replication.sgml
43	MOD	57	9	完成	ChenHuajun	maintenance.sgml
44	MOD	601	4	完成	sizhitu	monitoring.sgml
45	MOD	15	1	完成	ChenHuajun	mvcc.sgml
46	MOD	59	0	完成	chegong18	oid2name.sgml
47	MOD	36	23	完成	chegong18	pageinspect.sgml
48	MOD	4	25	完成	ChenHuajun	parallel.sgml
49	MOD	89	0	完成	ChenHuajun	perform.sgml
50	MOD	1	0	完成	ChenHuajun	pgstandby.sgml
51	MOD	82	0	完成	ChenHuajun	pgstatstatements.sgml
52	MOD	34	0	完成	ChenHuajun	pgtrgm.sgml
53	MOD	114	0	完成	chegong18	planstats.sgml
54	MOD	5	0	完成	chegong18	plhandler.sgml
55	MOD	140	20	完成	chegong18	plpgsql.sgml
56	MOD	0	18	完成	chegong18	pltcl.sgml
57	MOD	15	0	完成	chegong18	postgres-fdw.sgml
58	MOD	2	1	完成	ChenHuajun	postgres.sgml
59	MOD	1	0	完成	chegong18	problems.sgml
60	MOD	116	0	完成	chegong18	protocol.sgml
61	MOD	78	0	完成	chegong18	queries.sgml
62	MOD	17	9	完成	chegong18	rangetypes.sgml
63	DEL	0	509	完成(*)		recovery-config.sgml
64	MOD	13	0	完成	chegong18	ref/abort.sgml
65	MOD	1	1	完成		ref/allfiles.sgml
66	MOD	26	4	完成	chegong18	ref/alter_default_privileges.sgml
67	MOD	18	0	完成	chegong18	ref/alter_domain.sgml
68	MOD	3	22	完成	jingsam	ref/alter_foreign_table.sgml
69	MOD	19	0	完成	chegong18	ref/alter_function.sgml
70	MOD	8	0	完成	chegong18	ref/alter_index.sgml
71	MOD	2	0	完成	chegong18	ref/alter_subscription.sgml
72	MOD	113	47	完成	chegong18	ref/alter_table.sgml
73	MOD	3	0	完成	chegong18	ref/alter_type.sgml
74	MOD	44	0	完成	chegong18	ref/analyze.sgml
75	MOD	11	0	完成	chegong18	ref/clusterdb.sgml
76	MOD	21	1	完成	chegong18	ref/commit.sgml
77	MOD	54	18	完成	sunshinerxu	ref/copy.sgml
78	MOD	9	0	完成	chegong18	ref/create_access_method.sgml
79	MOD	19	0	完成	chegong18	ref/create_aggregate.sgml
80	MOD	29	0	完成	chegong18	ref/create_collation.sgml
81	MOD	24	0	完成	chegong18	ref/create_domain.sgml
82	MOD	58	0	完成	jingsam	ref/create_foreign_table.sgml
83	MOD	15	0	完成	chegong18	ref/create_function.sgml
84	MOD	67	2	完成	chegong18	ref/create_index.sgml
85	MOD	18	1	完成	chegong18	ref/create_materialized_view.sgml
86	MOD	35	0	完成	chegong18	ref/create_statistics.sgml
87	MOD	390	110	完成	chegong18	ref/create_table.sgml
88	MOD	26	12	完成	chegong18	ref/create_table_as.sgml
89	MOD	13	0	完成	chegong18	ref/create_tablespace.sgml
90	MOD	4	0	完成	chegong18	ref/create_trigger.sgml
91	MOD	11	0	完成	chegong18	ref/createdb.sgml
92	MOD	11	0	完成	chegong18	ref/createuser.sgml
93	MOD	5	0	完成	chegong18	ref/drop_index.sgml
94	MOD	1	0	完成	chegong18	ref/drop_owned.sgml
95	MOD	11	0	完成	chegong18	ref/dropdb.sgml
96	MOD	11	0	完成	chegong18	ref/dropuser.sgml
97	MOD	13	0	完成	chegong18	ref/end.sgml
98	MOD	12	0	完成	ChenHuajun	ref/explain.sgml
99	MOD	26	278	完成	chegong18	ref/grant.sgml
100	MOD	15	0	完成	chegong18	ref/initdb.sgml
101	MOD	7	2	完成	ChenHuajun	ref/insert.sgml
102	MOD	13	0	完成	chegong18	ref/pg_basebackup.sgml
103	NEW	228	0	完成	sunshinerxu	ref/pg_checksums.sgml
104	MOD	11	0	完成	chegong18	ref/pg_controldata.sgml
105	MOD	13	0	完成	chegong18	ref/pg_ctl-ref.sgml
106	MOD	79	15	完成	chegong18	ref/pg_dump.sgml
107	MOD	71	14	完成	chegong18	ref/pg_dumpall.sgml
108	MOD	7	0	完成	chegong18	ref/pg_isready.sgml
109	MOD	17	0	完成	chegong18	ref/pg_receivewal.sgml
110	MOD	7	0	完成	chegong18	ref/pg_recvlogical.sgml
111	MOD	17	0	完成	chegong18	ref/pg_resetwal.sgml
112	MOD	13	0	完成	chegong18	ref/pg_restore.sgml
113	MOD	59	0	完成	chegong18	ref/pg_rewind.sgml
114	DEL	0	122	完成(*)		ref/pg_verify_checksums.sgml
115	MOD	27	2	完成	chegong18	ref/pg_waldump.sgml
116	MOD	2	0	完成	chegong18	ref/pgarchivecleanup.sgml
117	MOD	81	12	完成	chegong18	ref/pgbench.sgml
118	MOD	103	4	完成	chegong18	ref/pgupgrade.sgml
119	MOD	36	4	完成	chegong18	ref/prepare.sgml
120	MOD	159	2	完成	chegong18	ref/psql-ref.sgml
121	MOD	5	0	完成	chegong18	ref/reassign_owned.sgml
122	MOD	2	0	完成	chegong18	ref/refresh_materialized_view.sgml
123	MOD	197	1	完成	chegong18	ref/reindex.sgml
124	MOD	21	0	完成	chegong18	ref/reindexdb.sgml
125	MOD	9	8	完成	chegong18	ref/revoke.sgml
126	MOD	21	1	完成	chegong18	ref/rollback.sgml
127	MOD	1	0	完成	chegong18	ref/security_label.sgml
128	MOD	55	1	完成	chegong18	ref/select.sgml
129	MOD	7	0	完成	chegong18	ref/select_into.sgml
130	MOD	2	0	完成	chegong18	ref/set_role.sgml
131	MOD	3	0	完成	chegong18	ref/truncate.sgml
132	MOD	24	0	完成	chegong18	ref/update.sgml
133	MOD	82	0	完成	chegong18	ref/vacuum.sgml
134	MOD	95	0	完成	chegong18	ref/vacuumdb.sgml
135	MOD	1	1	完成	ChenHuajun	reference.sgml
136	MOD	97	2	完成	chegong18	regress.sgml
137	DEL	0	5368	完成		release-11.sgml
138.1	NEW	999	0	完成	sizhitu	release-12.sgml:1-999
138.2	NEW	998	0	完成	sizhitu	release-12.sgml:1000-1997
138.3	NEW	991	0	完成	sizhitu	release-12.sgml:1998-2988
138.4	NEW	1009	0	完成	sizhitu	release-12.sgml:2989-3998
138.5	NEW	990	0	完成	sizhitu	release-12.sgml:3999-4989
138.6	NEW	1520	0	完成	sizhitu	release-12.sgml:4990-6510
139	MOD	5	58	完成	ChenHuajun	release.sgml
140	MOD	8	40	完成	chegong18	rules.sgml
141	MOD	202	17	完成	chegong18	runtime.sgml
142	MOD	29	0	完成	chegong18	sources.sgml
143	MOD	61	0	完成	chegong18	spgist.sgml
144	MOD	28	0	完成	chegong18	spi.sgml
145	MOD	6	0	完成	chegong18	sslinfo.sgml
146	MOD	35	0	完成	chegong18	storage.sgml
147	NEW	111	0	完成	sunshinerxu	tableam.sgml
148	MOD	5	1	完成	chegong18	tablesample-method.sgml
149	MOD	28	8	完成	chegong18	textsearch.sgml
150	MOD	27	0	完成	chegong18	trigger.sgml
151	MOD	29	17	完成	chegong18	user-manag.sgml
152	MOD	35	0	完成	chegong18	vacuumlo.sgml
153	MOD	126	62	完成	chegong18	xfunc.sgml
154	MOD	4	0	完成	messon007	xindex.sgml
155	MOD	13	0	完成	chegong18	xoper.sgml
156	MOD	2	0	完成	chegong18	xplang.sgml
157	MOD	3	0	完成	messon007	xtypes.sgml
		18239	13026

*)PG12中，pg_verify_checksums.sgml改名为pg_checksums.sgml，recovery-config.sgml合并到config.sgml。这2个文件暂时没有从github仓库删除，以方便翻译者参考，翻译完成可以删除。