pg13

PostgreSQL 13.1中文手册的翻译

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

1) 13.1的翻译基线

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

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

2) 13.1的翻译步骤

clone自己的git仓库

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

下载12.2和13.1的源码

https://ftp.postgresql.org/pub/source/v12.2/postgresql-12.2.tar.gz
https://ftp.postgresql.org/pub/source/v13.1/postgresql-13.1.tar.gz

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

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

13.1新增sgml的翻译

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

13.1相对12.2变更的sgml的翻译

1. 对比13.1源码中的英文原始sgml和12.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"的文件是13.1新增的原始英文sgml，其余sgml来自12.2中文sgml。

NO	修改类型	A&M	DEL	翻译状态	翻译者	sgml
1	MOD	4	0	已完成	chegong18	acronyms.sgml
2	MOD	75	0	已完成	chegong18	adminpack.sgml
3	MOD	26	0	已完成	chegong18	advanced.sgml
4	MOD	24	1	已完成	chegong18	amcheck.sgml
5	MOD	5	0	已完成	chegong18	array.sgml
6	MOD	21	0	已完成	chegong18	auto-explain.sgml
7	NEW	216	0	已完成	chegong18	backup-manifest.sgml
8	MOD	13	0	已完成	chegong18	bgworker.sgml
9	MOD	74	0	已完成	chegong18	biblio.sgml
10	MOD	4	3	已完成	chegong18	bki.sgml
11	MOD	62	20	已完成	chegong18	bloom.sgml
12	MOD	39	0	已完成	chegong18	brin.sgml
13	MOD	6	0	已完成	chegong18	btree-gin.sgml
14	MOD	6	0	已完成	chegong18	btree-gist.sgml
15	MOD	566	80	已完成	chegong18	btree.sgml
16	MOD	5922	346	已完成	chegong18	catalogs.sgml
17	MOD	1029	301	已完成	chegong18	charset.sgml
18	MOD	10	0	已完成	chegong18	citext.sgml
19	MOD	18	5	已完成	chegong18	client-auth.sgml
20	NEW	101	0	已完成	chegong18	color.sgml
21	MOD	705	43	已完成	chegong18	config.sgml
22	MOD	13	17	已完成	chegong18	contrib.sgml
23	MOD	368	30	已完成	chegong18	cube.sgml
24	MOD	247	66	已完成	chegong18	datatype.sgml
25	MOD	205	0	已完成	chegong18	datetime.sgml
26	MOD	4	1	已完成	chegong18	dblink.sgml
27	MOD	109	15	已完成	chegong18	ddl.sgml
28	MOD	1	0	已完成	chegong18	dfunc.sgml
29	MOD	16	0	已完成	chegong18	dict-int.sgml
30	MOD	10	0	已完成	chegong18	docguide.sgml
31	MOD	162	1	已完成	chegong18	earthdistance.sgml
32	MOD	61	0	已完成	chegong18	ecpg.sgml
33	MOD	2	0	已完成	chegong18	errcodes.sgml
34	MOD	120	0	已完成	chegong18	event-trigger.sgml
35	MOD	392	53	已完成	chegong18	extend.sgml
36	MOD	6	0	已完成	chegong18	external-projects.sgml
37	MOD	9	0	已完成	chegong18	fdwhandler.sgml
38	MOD	16	5	已完成	chegong18	features.sgml
39	MOD	9	0	已完成	chegong18	file-fdw.sgml
40	MOD	4	0	已完成	ChenHuajun	filelist.sgml
41	MOD	20677	7781	已完成	chegong18	func.sgml
42	MOD	6	0	已完成	chegong18	fuzzystrmatch.sgml
43	MOD	13	43	已完成	chegong18	geqo.sgml
44	MOD	27	0	已完成	chegong18	gin.sgml
45	MOD	160	0	已完成	chegong18	gist.sgml
46	NEW	1949	0	已完成	chegong18	glossary.sgml
47	MOD	82	14	已完成	chegong18	high-availability.sgml
48	MOD	1	0	已完成	chegong18	history.sgml
49	MOD	615	64	已完成	chegong18	hstore.sgml
50	MOD	8	0	已完成	chegong18	indexam.sgml
51	MOD	60	19	已完成	chegong18	indices.sgml
52	MOD	4096	273	已完成	chegong18	information_schema.sgml
53	MOD	18	1	已完成	YuanHao	install-windows.sgml
54	MOD	671	442	已完成	YuanHao	installation.sgml
55	MOD	342	0	已完成	YuanHao	intarray.sgml
56	MOD	1	0	已完成	YuanHao	intro.sgml
57	MOD	68	0	已完成	YuanHao	isn.sgml
58	MOD	2	0	已完成	YuanHao	jit.sgml
59	MOD	37	2	已完成	YuanHao	json.sgml
60	MOD	3	0	已完成	YuanHao	legal.sgml
61	MOD	899	571	已完成	chegong18	libpq.sgml
62	MOD	6	0	已完成	chegong18	lo.sgml
63	MOD	80	0	已完成	chegong18	lobj.sgml
64	MOD	38	0	已完成	chegong18	logical-replication.sgml
65	MOD	7	0	已完成	chegong18	logicaldecoding.sgml
66	MOD	462	1	已完成	chegong18	ltree.sgml
67	MOD	34	2	已完成	chegong18	maintenance.sgml
68	MOD	46	2	已完成	chegong18	manage-ag.sgml
69	MOD	4699	1446	已完成	chegong18	monitoring.sgml
70	MOD	72	0	已完成	chegong18	mvcc.sgml
71	MOD	1	0	已完成	YuanHao	nls.sgml
72	MOD	7	0	已完成	YuanHao	oid2name.sgml
73	MOD	130	0	已完成	YuanHao	pageinspect.sgml
74	MOD	4	0	已完成	YuanHao	parallel.sgml
75	MOD	73	29	已完成	YuanHao	perform.sgml
76	MOD	90	4	已完成	YuanHao	pgbuffercache.sgml
77	MOD	11	0	已完成	YuanHao	pgcrypto.sgml
78	MOD	353	3	已完成	YuanHao	pgstatstatements.sgml
79	MOD	254	0	已完成	YuanHao	pgtrgm.sgml
80	MOD	17	0	已完成	YuanHao	planstats.sgml
81	MOD	47	0	已完成	YuanHao	plperl.sgml
82	MOD	53	4	已完成	YuanHao	plpgsql.sgml
83	MOD	8	12	已完成	YuanHao	plpython.sgml
84	MOD	2	0	已完成	YuanHao	pltcl.sgml
85	MOD	39	0	已完成	YuanHao	postgres-fdw.sgml
86	MOD	12	0	已完成	ChenHuajun	postgres.sgml
87	MOD	55	0	已完成	YuanHao	protocol.sgml
88	MOD	35	0	已完成	YuanHao	queries.sgml
89	MOD	1	0	已完成	ChenHuajun	ref/allfiles.sgml
90	MOD	14	2	已完成	YuanHao	ref/alter_collation.sgml
91	MOD	7	0	已完成	YuanHao	ref/alter_function.sgml
92	MOD	8	0	已完成	YuanHao	ref/alter_index.sgml
93	MOD	5	6	已完成	YuanHao	ref/alter_materialized_view.sgml
94	MOD	4	0	已完成	YuanHao	ref/alter_opfamily.sgml
95	MOD	3	0	已完成	YuanHao	ref/alter_role.sgml
96	MOD	18	0	已完成	YuanHao	ref/alter_statistics.sgml
97	MOD	1	1	已完成	YuanHao	ref/alter_subscription.sgml
98	MOD	85	2	已完成	YuanHao	ref/alter_table.sgml
99	MOD	7	0	已完成	YuanHao	ref/alter_tablespace.sgml
100	MOD	5	0	已完成	YuanHao	ref/alter_trigger.sgml
101	MOD	131	6	已完成	YuanHao	ref/alter_type.sgml
102	MOD	21	1	已完成	YuanHao	ref/alter_view.sgml
103	MOD	4	0	已完成	YuanHao	ref/checkpoint.sgml
104	MOD	20	0	已完成	YuanHao	ref/clusterdb.sgml
105	MOD	5	0	已完成	YuanHao	ref/comment.sgml
106	MOD	1	0	已完成	YuanHao	ref/commit_prepared.sgml
107	MOD	2	1	已完成	YuanHao	ref/copy.sgml
108	MOD	5	3	已完成	YuanHao	ref/create_aggregate.sgml
109	MOD	4	0	已完成	YuanHao	ref/create_cast.sgml
110	MOD	4	0	已完成	YuanHao	ref/create_collation.sgml
111	MOD	20	0	已完成	YuanHao	ref/create_conversion.sgml
112	MOD	31	0	已完成	YuanHao	ref/create_database.sgml
113	MOD	1	0	已完成	YuanHao	ref/create_event_trigger.sgml
114	MOD	49	37	已完成	YuanHao	ref/create_extension.sgml
115	MOD	5	0	已完成	YuanHao	ref/create_foreign_table.sgml
116	MOD	4	0	已完成	YuanHao	ref/create_function.sgml
117	MOD	4	0	已完成	YuanHao	ref/create_group.sgml
118	MOD	66	3	已完成	YuanHao	ref/create_index.sgml
119	MOD	26	74	已完成	YuanHao	ref/create_language.sgml
120	MOD	3	0	已完成	YuanHao	ref/create_materialized_view.sgml
121	MOD	8	0	已完成	YuanHao	ref/create_opclass.sgml
122	MOD	8	0	已完成	YuanHao	ref/create_operator.sgml
123	MOD	2	0	已完成	YuanHao	ref/create_procedure.sgml
124	MOD	34	2	已完成	YuanHao	ref/create_publication.sgml
125	MOD	14	0	已完成	YuanHao	ref/create_role.sgml
126	MOD	1	0	已完成	YuanHao	ref/create_sequence.sgml
127	MOD	1	0	已完成	YuanHao	ref/create_statistics.sgml
128	MOD	2	1	已完成	YuanHao	ref/create_subscription.sgml
129	MOD	71	2	已完成	YuanHao	ref/create_table.sgml
130	MOD	2	0	已完成	YuanHao	ref/create_table_as.sgml
131	MOD	7	0	已完成	YuanHao	ref/create_tablespace.sgml
132	MOD	4	0	已完成	YuanHao	ref/create_transform.sgml
133	MOD	8	9	已完成	YuanHao	ref/create_trigger.sgml
134	MOD	0	12	已完成	YuanHao	ref/create_type.sgml
135	MOD	3	1	已完成	YuanHao	ref/create_view.sgml
136	MOD	6	2	已完成	YuanHao	ref/createdb.sgml
137	MOD	2	0	已完成	YuanHao	ref/createuser.sgml
138	MOD	4	0	已完成	YuanHao	ref/declare.sgml
139	MOD	10	0	已完成	YuanHao	ref/delete.sgml
140	MOD	1	0	已完成	YuanHao	ref/do.sgml
141	MOD	4	0	已完成	YuanHao	ref/drop_cast.sgml
142	MOD	4	0	已完成	YuanHao	ref/drop_collation.sgml
143	MOD	4	0	已完成	LiuMengzhen	ref/drop_conversion.sgml
144	MOD	29	0	已完成	LiuMengzhen	ref/drop_database.sgml
145	MOD	5	0	已完成	LiuMengzhen	ref/drop_foreign_table.sgml
146	MOD	1	1	已完成	LiuMengzhen	ref/drop_function.sgml
147	MOD	2	0	已完成	LiuMengzhen	ref/drop_index.sgml
148	MOD	1	1	已完成	LiuMengzhen	ref/drop_procedure.sgml
149	MOD	1	1	已完成	LiuMengzhen	ref/drop_routine.sgml
150	MOD	4	0	已完成	LiuMengzhen	ref/drop_transform.sgml
151	MOD	17	0	已完成	LiuMengzhen	ref/dropdb.sgml
152	MOD	2	0	已完成	LiuMengzhen	ref/dropuser.sgml
153	MOD	26	0	已完成	LiuMengzhen	ref/ecpg-ref.sgml
154	MOD	2	1	已完成	LiuMengzhen	ref/execute.sgml
155	MOD	20	1	已完成	LiuMengzhen	ref/explain.sgml
156	MOD	20	2	已完成	LiuMengzhen	ref/grant.sgml
157	MOD	6	2	已完成	LiuMengzhen	ref/initdb.sgml
158	MOD	27	1	已完成	LiuMengzhen	ref/insert.sgml
159	MOD	24	7	已完成	LiuMengzhen	ref/listen.sgml
160	MOD	1	0	已完成	LiuMengzhen	ref/load.sgml
161	MOD	2	1	已完成	LiuMengzhen	ref/lock.sgml
162	MOD	3	0	已完成	LiuMengzhen	ref/notify.sgml
163	MOD	270	28	已完成	LiuMengzhen	ref/pg_basebackup.sgml
164	MOD	5	0	已完成	LiuMengzhen	ref/pg_checksums.sgml
165	MOD	4	0	已完成	LiuMengzhen	ref/pg_config-ref.sgml
166	MOD	2	0	已完成	LiuMengzhen	ref/pg_controldata.sgml
167	MOD	2	0	已完成	LiuMengzhen	ref/pg_ctl-ref.sgml
168	MOD	57	9	已完成	LiuMengzhen	ref/pg_dump.sgml
169	MOD	18	13	已完成	LiuMengzhen	ref/pg_dumpall.sgml
170	MOD	7	4	已完成	LiuMengzhen	ref/pg_isready.sgml
171	MOD	13	2	已完成	LiuMengzhen	ref/pg_receivewal.sgml
172	MOD	10	0	已完成	LiuMengzhen	ref/pg_recvlogical.sgml
173	MOD	2	0	已完成	LiuMengzhen	ref/pg_resetwal.sgml
174	MOD	19	1	已完成	LiuMengzhen	ref/pg_restore.sgml
175	MOD	115	4	已完成	LiuMengzhen	ref/pg_rewind.sgml
176	NEW	289	0	已完成	LiuMengzhen	ref/pg_verifybackup.sgml
177	MOD	14	0	已完成	LiuMengzhen	ref/pg_waldump.sgml
178	MOD	16	0	已完成	LiuMengzhen	ref/pgarchivecleanup.sgml
179	MOD	740	2	已完成	LiuMengzhen	ref/pgbench.sgml
180	MOD	15	0	已完成	LiuMengzhen	ref/pgtestfsync.sgml
181	MOD	4	0	已完成	LiuMengzhen	ref/pgtesttiming.sgml
182	MOD	40	2	已完成	LiuMengzhen	ref/pgupgrade.sgml
183	MOD	8	1	已完成	LiuMengzhen	ref/postgres-ref.sgml
184	MOD	1	0	已完成	LiuMengzhen	ref/postmaster.sgml
185	MOD	3	0	已完成	LiuMengzhen	ref/prepare.sgml
186	MOD	1	0	已完成	LiuMengzhen	ref/prepare_transaction.sgml
187	MOD	284	27	已完成	LiuMengzhen	ref/psql-ref.sgml
188	MOD	19	1	已完成	LiuMengzhen	ref/reindex.sgml
189	MOD	46	0	已完成	LiuMengzhen	ref/reindexdb.sgml
190	MOD	27	0	已完成	LiuMengzhen	ref/revoke.sgml
191	MOD	1	0	已完成	YuanHao	ref/rollback_prepared.sgml
192	MOD	61	6	已完成	YuanHao	ref/select.sgml
193	MOD	1	0	已完成	YuanHao	ref/select_into.sgml
194	MOD	5	0	已完成	YuanHao	ref/set_constraints.sgml
195	MOD	5	0	已完成	YuanHao	ref/set_session_auth.sgml
196	MOD	5	0	已完成	YuanHao	ref/set_transaction.sgml
197	MOD	1	1	已完成	YuanHao	ref/truncate.sgml
198	MOD	17	0	已完成	YuanHao	ref/update.sgml
199	MOD	55	0	已完成	YuanHao	ref/vacuum.sgml
200	MOD	40	0	已完成	YuanHao	ref/vacuumdb.sgml
201	MOD	8	0	已完成	LiuMengzhen	ref/values.sgml
202	MOD	1	0	已完成	ChenHuajun	reference.sgml
203	MOD	0	8	已完成	LiuMengzhen	regress.sgml
204	DEL	0	6509	已完成	ChenHuajun	release-12.sgml
205	NEW	4572	0	已完成	sizhitu	release-13.sgml
206	MOD	8	0	已完成	ChenHuajun	release.sgml
207	MOD	3	0	已完成	LiuMengzhen	replication-origins.sgml
208	MOD	5	0	已完成	LiuMengzhen	rules.sgml
209	MOD	184	173	已完成	LiuMengzhen	runtime.sgml
210	MOD	107	23	已完成	LiuMengzhen	seg.sgml
211	MOD	76	0	已完成	LiuMengzhen	sepgsql.sgml
212	MOD	36	0	已完成	LiuMengzhen	sources.sgml
213	MOD	41	0	已完成	LiuMengzhen	spgist.sgml
214	MOD	21	5	已完成	LiuMengzhen	spi.sgml
215	MOD	4	0	已完成	LiuMengzhen	sslinfo.sgml
216	MOD	1	0	已完成	LiuMengzhen	start.sgml
217	MOD	2	0	已完成	LiuMengzhen	storage.sgml
218	MOD	58	52	已完成	LiuMengzhen	syntax.sgml
219	MOD	1	0	已完成	LiuMengzhen	tableam.sgml
220	MOD	93	0	已完成	LiuMengzhen	tablefunc.sgml
221	MOD	6	0	已完成	LiuMengzhen	tcn.sgml
222	MOD	118	9	已完成	LiuMengzhen	textsearch.sgml
223	MOD	28	0	已完成	LiuMengzhen	trigger.sgml
224	MOD	6	0	已完成	LiuMengzhen	tsm-system-rows.sgml
225	MOD	6	0	已完成	LiuMengzhen	tsm-system-time.sgml
226	MOD	35	1	已完成	LiuMengzhen	typeconv.sgml
227	MOD	6	0	已完成	LiuMengzhen	unaccent.sgml
228	MOD	2	0	已完成	LiuMengzhen	user-manag.sgml
229	MOD	134	47	已完成	LiuMengzhen	uuid-ossp.sgml
230	MOD	7	0	已完成	LiuMengzhen	vacuumlo.sgml
231	MOD	4	0	已完成	LiuMengzhen	wal.sgml
232	MOD	145	29	已完成	YuanHao	xfunc.sgml
233	MOD	91	0	已完成	YuanHao	xindex.sgml
234	MOD	111	81	已完成	YuanHao	xml2.sgml
235	MOD	13	0	已完成	YuanHao	xoper.sgml
236	MOD	2	2	已完成	YuanHao	xplang.sgml
		56164	18923