Skip to content
地上马 edited this page Aug 2, 2023 · 111 revisions

PostgreSQL 14.1中文手册的翻译

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

1) 14.1的翻译基线

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

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

2) 14.1的翻译步骤

clone自己的git仓库

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

下载13.1和14.1的源码

https://ftp.postgresql.org/pub/source/v14.1/postgresql-14.1.tar.gz
https://ftp.postgresql.org/pub/source/v13.1/postgresql-13.1.tar.gz

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

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

14.1新增sgml的翻译

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

14.1相对13.1变更的sgml的翻译

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

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

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

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

3) 翻译的注意点

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

4) 翻译进度

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

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

NO 修改类型 A&M DEL 翻译状态 翻译者 sgml
1 MOD 33 0 完成 chegong18 acronyms.sgml
2 MOD 3 0 完成 chegong18 advanced.sgml
3 MOD 206 1 完成 chegong18 amcheck.sgml
4 NEW 22 0 完成 chegong18 appendix-obsolete-default-roles.sgml
5 NEW 24 0 完成 chegong18 appendix-obsolete-pgreceivexlog.sgml
6 NEW 24 0 完成 chegong18 appendix-obsolete-pgresetxlog.sgml
7 NEW 24 0 完成 chegong18 appendix-obsolete-pgxlogdump.sgml
8 NEW 58 0 完成 chegong18 appendix-obsolete-recovery-config.sgml
9 NEW 42 0 完成 chegong18 appendix-obsolete.sgml
10 MOD 63 3 完成 chegong18 arch-dev.sgml
11 MOD 43 0 完成 chegong18 backup.sgml
12 MOD 9 2 完成 chegong18 bgworker.sgml
13 MOD 33 15 完成 chegong18 bki.sgml
14 MOD 17 0 完成 chegong18 bloom.sgml
15 MOD 786 129 完成 chegong18 brin.sgml
16 MOD 125 9 完成 chegong18 btree.sgml
17 MOD 817 8 完成 chegong18 catalogs.sgml
18 MOD 4 4 完成 chegong18 charset.sgml
19 MOD 101 22 完成 chegong18 client-auth.sgml
20 MOD 901 143 完成 chegong18 config.sgml
21 MOD 7 1 完成 ChenHuajun contrib.sgml
22 MOD 1 8 完成 sirlipeng cube.sgml
23 MOD 253 11 完成 sirlipeng datatype.sgml
24 MOD 40 3 完成 sirlipeng datetime.sgml
25 MOD 5 0 完成 sirlipeng dblink.sgml
26 MOD 293 117 完成 sirlipeng ddl.sgml
27 MOD 4 0 完成 sirlipeng dml.sgml
28 MOD 28 2 完成 chegong18 docguide.sgml
29 MOD 258 19 完成 chegong18 ecpg.sgml
30 MOD 61 6 完成 chegong18 extend.sgml
31 MOD 1 0 完成 sirlipeng external-projects.sgml
32 MOD 275 1 完成 chegong18 fdwhandler.sgml
33 MOD 5 0 完成 sirlipeng file-fdw.sgml
34 MOD 13 1 完成 ChenHuajun filelist.sgml
35 MOD 1589 265 完成 chegong18 func.sgml
36 MOD 54 1 完成 sizhitu gin.sgml
37 MOD 244 102 完成 chegong18 gist.sgml
38 MOD 15 0 完成 sizhitu glossary.sgml
39 NEW 162 0 完成 sirlipeng hash.sgml
40 MOD 121 193 完成 sizhitu high-availability.sgml
41 MOD 45 10 完成 sizhitu hstore.sgml
42 MOD 92 1 完成 sizhitu indexam.sgml
43 MOD 77 32 完成 sizhitu indices.sgml
44 MOD 443 0 完成 chegong18 information_schema.sgml
45 NEW 24 0 完成 sirlipeng install-binaries.sgml
46 MOD 31 8 完成 sizhitu install-windows.sgml
47 MOD 78 6 完成 sizhitu installation.sgml
48 MOD 4 8 完成 sizhitu intarray.sgml
49 MOD 102 0 完成 sizhitu json.sgml
50 MOD 17 0 完成 sizhitu keywords.sgml
51 MOD 3 0 完成 sizhitu legal.sgml
52 MOD 974 62 完成 chegong18 libpq.sgml
53 MOD 8 3 完成 sizhitu lobj.sgml
54 MOD 51 0 完成 sizhitu logical-replication.sgml
55 MOD 607 0 完成 chegong18 logicaldecoding.sgml
56 MOD 1 0 完成 sirlipeng ltree.sgml
57 MOD 25 0 完成 sizhitu maintenance.sgml
58 MOD 642 23 完成 chegong18 monitoring.sgml
59 MOD 14 1 完成 sizhitu mvcc.sgml
60 MOD 2 0 完成 sirlipeng nls.sgml
61 NEW 33 0 完成 sirlipeng oldsnapshot.sgml
62 MOD 110 0 完成 sizhitu pageinspect.sgml
63 MOD 43 0 完成 sizhitu parallel.sgml
64 MOD 1 0 完成 sirlipeng passwordcheck.sgml
65 MOD 34 2 完成 sizhitu perform.sgml
66 MOD 1 0 完成 sirlipeng pgbuffercache.sgml
67 MOD 22 0 完成 sizhitu pgcrypto.sgml
68 MOD 0 7 完成 sirlipeng pgfreespacemap.sgml
69 MOD 2 0 完成 sirlipeng pgrowlocks.sgml
70 MOD 104 0 完成 sizhitu pgstatstatements.sgml
71 NEW 107 0 完成 songjinzhou pgsurgery.sgml
72 MOD 6 4 完成 sizhitu pgtrgm.sgml
73 MOD 4 52 完成 chegong18 plhandler.sgml
74 MOD 2 0 完成 sirlipeng plperl.sgml
75 MOD 201 7 完成 sizhitu plpgsql.sgml
76 MOD 3 0 完成 sizhitu plpython.sgml
77 MOD 4 0 完成 sizhitu pltcl.sgml
78 MOD 294 0 完成 sizhitu postgres-fdw.sgml
79 MOD 3 0 完成 ChenHuajun postgres.sgml
80 MOD 516 57 完成 sizhitu protocol.sgml
81 MOD 311 8 完成 sizhitu queries.sgml
82 MOD 47 21 完成 sizhitu query.sgml
83 MOD 81 0 完成 sizhitu rangetypes.sgml
84 MOD 4 0 完成 sizhitu abort.sgml
85 MOD 2 0 完成 ChenHuajun allfiles.sgml
86 MOD 2 0 完成 sirlipeng alter_aggregate.sgml
87 MOD 19 0 完成 sirlipeng alter_collation.sgml
88 MOD 1 0 完成 sirlipeng alter_conversion.sgml
89 MOD 1 0 完成 sirlipeng alter_database.sgml
90 MOD 2 0 完成 sirlipeng alter_domain.sgml
91 MOD 1 0 完成 sirlipeng alter_event_trigger.sgml
92 MOD 1 0 完成 sirlipeng alter_extension.sgml
93 MOD 1 0 完成 sirlipeng alter_foreign_data_wrapper.sgml
94 MOD 11 0 完成 sirlipeng alter_foreign_table.sgml
95 MOD 3 0 完成 sirlipeng alter_function.sgml
96 MOD 4 0 完成 sirlipeng alter_group.sgml
97 MOD 6 0 完成 sirlipeng alter_index.sgml
98 MOD 1 0 完成 sirlipeng alter_language.sgml
99 MOD 1 0 完成 sirlipeng alter_large_object.sgml
100 MOD 5 0 完成 sirlipeng alter_materialized_view.sgml
101 MOD 1 0 完成 sirlipeng alter_opclass.sgml
102 MOD 5 1 完成 sirlipeng alter_operator.sgml
103 MOD 3 0 完成 sirlipeng alter_opfamily.sgml
104 MOD 2 0 完成 sirlipeng alter_policy.sgml
105 MOD 8 0 完成 sirlipeng alter_procedure.sgml
106 MOD 3 0 完成 sirlipeng alter_publication.sgml
107 MOD 14 0 完成 sirlipeng alter_role.sgml
108 MOD 4 0 完成 sirlipeng alter_routine.sgml
109 MOD 1 0 完成 sirlipeng alter_schema.sgml
110 MOD 1 0 完成 sirlipeng alter_sequence.sgml
111 MOD 1 0 完成 sirlipeng alter_server.sgml
112 MOD 2 0 完成 sirlipeng alter_statistics.sgml
113 MOD 41 0 完成 sirlipeng alter_subscription.sgml
114 MOD 95 0 完成 sirlipeng alter_table.sgml
115 MOD 1 0 完成 sirlipeng alter_tablespace.sgml
116 MOD 1 0 完成 sirlipeng alter_trigger.sgml
117 MOD 1 0 完成 sirlipeng alter_tsconfig.sgml
118 MOD 1 0 完成 sirlipeng alter_tsdictionary.sgml
119 MOD 10 0 完成 sirlipeng alter_type.sgml
120 MOD 2 0 完成 sirlipeng alter_user.sgml
121 MOD 2 0 完成 sirlipeng alter_user_mapping.sgml
122 MOD 1 0 完成 sirlipeng alter_view.sgml
123 MOD 12 1 完成 ChenHuajun analyze.sgml
124 MOD 8 0 完成 ChenHuajun begin.sgml
125 MOD 22 0 完成 ChenHuajun call.sgml
126 MOD 1 0 完成 sirlipeng close.sgml
127 MOD 27 0 完成 ChenHuajun cluster.sgml
128 MOD 3 2 完成 ChenHuajun comment.sgml
129 MOD 38 10 完成 ChenHuajun copy.sgml
130 MOD 1 0 完成 sirlipeng create_aggregate.sgml
131 MOD 1 0 完成 sirlipeng create_cast.sgml
132 MOD 9 0 完成 ChenHuajun create_conversion.sgml
133 MOD 4 0 完成 ChenHuajun create_database.sgml
134 MOD 1 0 完成 sirlipeng create_event_trigger.sgml
135 MOD 1 1 完成 sirlipeng create_extension.sgml
136 MOD 2 0 完成 sirlipeng create_foreign_table.sgml
137 MOD 123 1 完成 ChenHuajun create_function.sgml
138 MOD 77 14 完成 ChenHuajun create_index.sgml
139 MOD 2 5 完成 ChenHuajun create_language.sgml
140 MOD 8 0 完成 ChenHuajun create_materialized_view.sgml
141 MOD 3 0 完成 ChenHuajun create_opclass.sgml
142 MOD 7 12 完成 ChenHuajun create_operator.sgml
143 MOD 4 0 完成 ChenHuajun create_policy.sgml
144 MOD 64 4 完成 ChenHuajun create_procedure.sgml
145 MOD 7 0 完成 ChenHuajun create_role.sgml
146 MOD 1 0 完成 sirlipeng create_schema.sgml
147 MOD 112 0 完成 chegong18 create_statistics.sgml
148 MOD 35 0 完成 chegong18 create_subscription.sgml
149 MOD 101 0 完成 chegong18 create_table.sgml
150 MOD 10 0 完成 chegong18 create_table_as.sgml
151 MOD 1 0 完成 sirlipeng create_tablespace.sgml
152 MOD 1 0 完成 sirlipeng create_transform.sgml
153 MOD 60 14 完成 chegong18 create_trigger.sgml
154 MOD 91 2 完成 chegong18 create_type.sgml
155 MOD 1 0 完成 sirlipeng create_user.sgml
156 MOD 2 0 完成 sirlipeng create_user_mapping.sgml
157 MOD 5 0 完成 chegong18 create_view.sgml
158 MOD 2 0 完成 sirlipeng createdb.sgml
159 MOD 2 0 完成 sirlipeng createuser.sgml
160 MOD 41 11 完成 chegong18 declare.sgml
161 MOD 1 0 完成 sirlipeng delete.sgml
162 MOD 1 0 完成 whupyw drop_group.sgml
163 MOD 4 0 完成 whupyw drop_index.sgml
164 MOD 2 1 完成 whupyw drop_language.sgml
165 MOD 4 8 完成 whupyw drop_operator.sgml
166 MOD 2 0 完成 whupyw drop_owned.sgml
167 MOD 2 0 完成 whupyw drop_policy.sgml
168 MOD 83 1 完成 whupyw drop_procedure.sgml
169 MOD 3 0 完成 whupyw drop_role.sgml
170 MOD 36 0 完成 whupyw drop_routine.sgml
171 MOD 13 0 完成 whupyw drop_statistics.sgml
172 MOD 4 0 完成 whupyw drop_subscription.sgml
173 MOD 2 0 完成 whupyw drop_table.sgml
174 MOD 1 0 完成 whupyw drop_user.sgml
175 MOD 2 0 完成 whupyw drop_user_mapping.sgml
176 MOD 1 0 完成 whupyw dropdb.sgml
177 MOD 1 0 完成 whupyw dropuser.sgml
178 MOD 4 0 完成 chegong18 end.sgml
179 MOD 8 0 完成 chegong18 explain.sgml
180 MOD 2 0 完成 sirlipeng fetch.sgml
181 MOD 24 0 完成 chegong18 grant.sgml
182 MOD 26 0 完成 chegong18 initdb.sgml
183 MOD 3 0 完成 sirlipeng lock.sgml
184 NEW 649 0 完成 sirlipeng pg_amcheck.sgml
185 MOD 21 0 完成 chegong18 pg_basebackup.sgml
186 MOD 1 0 完成 sirlipeng pg_checksums.sgml
187 MOD 1 0 完成 sirlipeng pg_config-ref.sgml
188 MOD 2 1 完成 chegong18 pg_controldata.sgml
189 MOD 77 12 完成 chegong18 pg_dump.sgml
190 MOD 17 3 完成 chegong18 pg_dumpall.sgml
191 MOD 25 0 完成 chegong18 pg_receivewal.sgml
192 MOD 24 3 完成 chegong18 pg_resetwal.sgml
193 MOD 7 0 完成 chegong18 pg_restore.sgml
194 MOD 4 0 完成 chegong18 pg_rewind.sgml
195 MOD 2 0 完成 sirlipeng pg_verifybackup.sgml
196 MOD 0 7 完成 sirlipeng pgarchivecleanup.sgml
197 MOD 150 3 完成 chegong18 pgbench.sgml
198 MOD 23 0 完成 chegong18 pgupgrade.sgml
199 MOD 2 26 完成 chegong18 postgres-ref.sgml
200 MOD 4 0 完成 chegong18 prepare.sgml
201 MOD 4 0 完成 chegong18 prepare_transaction.sgml
202 MOD 110 8 完成 chegong18 psql-ref.sgml
203 MOD 3 0 完成 chegong18 reassign_owned.sgml
204 MOD 1 0 完成 sirlipeng refresh_materialized_view.sgml
205 MOD 89 0 完成 chegong18 reindex.sgml
206 MOD 17 5 完成 chegong18 reindexdb.sgml
207 MOD 16 0 完成 chegong18 revoke.sgml
208 MOD 1 0 完成 sirlipeng rollback.sgml
209 MOD 1 0 完成 sirlipeng rollback_to.sgml
210 MOD 2 0 完成 sirlipeng savepoint.sgml
211 MOD 2 1 完成 sirlipeng security_label.sgml
212 MOD 82 13 完成 chegong18 select.sgml
213 MOD 8 0 完成 chegong18 select_into.sgml
214 MOD 1 0 完成 sirlipeng set.sgml
215 MOD 13 0 完成 chegong18 set_role.sgml
216 MOD 2 0 完成 sirlipeng set_session_auth.sgml
217 MOD 12 0 完成 chegong18 set_transaction.sgml
218 MOD 1 0 完成 sirlipeng show.sgml
219 MOD 2 0 完成 sirlipeng start_transaction.sgml
220 MOD 3 0 完成 chegong18 truncate.sgml
221 MOD 68 0 完成 chegong18 vacuum.sgml
222 MOD 66 2 完成 chegong18 vacuumdb.sgml
223 MOD 1 0 完成 ChenHuajun reference.sgml
224 MOD 44 1 完成 chegong18 regress.sgml
225 NEW 5658 0 完成 sirlipeng release-14.sgml
226 MOD 1 0 完成 ChenHuajun release.sgml
227 MOD 10 0 完成 chegong18 rules.sgml
228 MOD 68 5 完成 chegong18 runtime.sgml
229 MOD 0 8 完成 sirlipeng seg.sgml
230 MOD 5 0 完成 chegong18 sepgsql.sgml
231 MOD 19 0 完成 messon007 sources.sgml
232 MOD 158 97 完成 chegong18 spgist.sgml
233 MOD 627 0 完成 chegong18 spi.sgml
234 MOD 4 0 完成 chegong18 sslinfo.sgml
235 MOD 7 1 完成 messon007 start.sgml
236 MOD 13 7 完成 messon007 storage.sgml
237 MOD 3 5 完成 messon007 syntax.sgml
238 MOD 4 0 完成 chegong18 tablefunc.sgml
239 MOD 1 0 完成 sirlipeng tablesample-method.sgml
240 MOD 22 0 完成 chegong18 test-decoding.sgml
241 MOD 10 0 完成 messon007 textsearch.sgml
242 MOD 10 0 完成 chegong18 trigger.sgml
243 MOD 1 0 完成 sirlipeng tsm-system-rows.sgml
244 MOD 1 0 完成 sirlipeng tsm-system-time.sgml
245 MOD 5 0 完成 messon007 typeconv.sgml
246 MOD 60 0 完成 chegong18 user-manag.sgml
247 MOD 3 0 完成 messon007 uuid-ossp.sgml
248 MOD 99 0 完成 chegong18 wal.sgml
249 MOD 3 0 完成 chegong18 xaggr.sgml
250 MOD 122 1 完成 chegong18 xfunc.sgml
251 MOD 24 4 完成 地上马 xindex.sgml
252 MOD 6 0 完成 chegong18 xoper.sgml
253 MOD 1 0 完成 sirlipeng xplang.sgml
21820 1679