Skip to content
韩悦悦 edited this page Jun 26, 2018 · 26 revisions

PostgreSQL 10.1中文手册的翻译

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

10.1的翻译基线

  1. 10.1的中文手册基于上一版的社区中文手册《PostgreSQL 9.6.0 中文手册》
  2. 10.1相对于9.6.0新增的sgml为来自10.1的英文sgml;其余sgml均为9.6.0的中文sgml

10.1的翻译步骤

1. clone自己的git仓库

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

2. 下载10.1和上一版本(9.6.0)的源码

https://ftp.postgresql.org/pub/source/v10.1/postgresql-10.1.tar.gz
https://ftp.postgresql.org/pub/source/v9.6.0/postgresql-9.6.0.tar.gz

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

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

4. PG 10.1新增sgml的翻译

  1. 翻译sgml

  2. 使用注释自动添加工具添加注释

    以acronyms.sgml文件为例,步骤如下

    cd pgdoc-cn
    python3 tools/pgdoc_add_commet.py postgresql/doc/src/sgml/acronyms.sgml ${原始10.1英文sgml解压目录}/postgresql-10.1/doc/src/sgml/acronyms.sgml ${临时sgml输出目录}/acronyms.sgml
    mv ${临时sgml输出目录}/acronyms.sgml postgresql/doc/src/sgml/acronyms.sgml

5. PG 10.1相对9.6.0变更的sgml的翻译

  1. 对比10.1和9.6.0英文原始sgml找到变更点

  2. 翻译变更内容并合并到github的sgml文件中

  3. 使用注释自动添加工具删除之前的注释

    以acronyms.sgml文件为例,步骤如下

    cd pgdoc-cn
    python3 tools/pgdoc_del_commet.py postgresql/doc/src/sgml/acronyms.sgml ${临时sgml输出目录}/acronyms.sgml
    mv ${临时sgml输出目录}/acronyms.sgml postgresql/doc/src/sgml/acronyms.sgml
  4. 使用注释自动添加工具重新添加注释

    以acronyms.sgml文件为例,步骤如下

    cd pgdoc-cn
    python3 tools/pgdoc_add_commet.py postgresql/doc/src/sgml/acronyms.sgml ${原始10.1英文sgml解压目录}/postgresql-10.1/doc/src/sgml/acronyms.sgml ${临时sgml输出目录}/acronyms.sgml
    mv ${临时sgml输出目录}/acronyms.sgml postgresql/doc/src/sgml/acronyms.sgml

注意:对不涉及注释变更的sgml,或已手动处理好注释的sgml,可以跳过3,4的注释处理。

6. 将翻译好的sgml提交PR

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

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

注意点

  1. 编辑sgml文件时,请务必事先阅读翻译的注意点
  2. 为在提交PR前检查翻译效果需要构建文档编译环境,构建步骤参考Readme.md,但是目前windows上的编译有问题,需要在Linux上编译。
  3. 在线翻译预览可以通过PostgreSQL 10.1 手册查看,PR被接受后,会被自动反映到在线文档中。

翻译进度

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

NO 修改类型 A&M DEL 翻译状态 翻译者 sgml
1 MOD 11 0 完成 tannineo acronyms.sgml
2 MOD 1 0 完成 tannineo adminpack.sgml
3 MOD 16 1 完成 tannineo advanced.sgml
4 NEW 273 0 完成 瀚高-韩悦悦 amcheck.sgml
5 MOD 74 13 完成 瀚高-韩悦悦 backup.sgml
6 MOD 9 18 完成 瀚高-韩悦悦 bgworker.sgml
7 MOD 34 63 完成 瀚高-韩悦悦 biblio.sgml
8 MOD 23 0 完成 瀚高-韩悦悦 brin.sgml
9 MOD 2 0 完成 瀚高-韩悦悦 btree-gin.sgml
10 MOD 5 0 完成 瀚高-韩悦悦 btree-gist.sgml
11 MOD 1099 12 完成 瀚高-韩悦悦 catalogs.sgml
12 MOD 366 0 完成 瀚高-韩悦悦 charset.sgml
13 MOD 5 0 完成 瀚高-韩悦悦 citext.sgml
14 MOD 167 0 完成 瀚高-韩悦悦 client-auth.sgml
15 MOD 475 53 完成 瀚高-韩悦悦 config.sgml
16 MOD 1 0 完成 瀚高-韩悦悦 contacts.sgml
17 MOD 1 1 完成 瀚高-韩悦悦 contrib.sgml
18 MOD 36 0 完成 瀚高-韩悦悦 custom-scan.sgml
19 MOD 127 41 完成 瀚高-韩悦悦 datatype.sgml
20 MOD 837 185 完成 瀚高-韩悦悦 ddl.sgml
21 MOD 14 28 完成 瀚高-韩悦悦 dfunc.sgml
22 MOD 99 4 完成 瀚高-韩悦悦 dml.sgml
23 MOD 109 445 完成 瀚高-韩悦悦 docguide.sgml
24 MOD 37 1 完成 瀚高-韩悦悦 ecpg.sgml
25 MOD 1 0 完成 瀚高-韩悦悦 event-trigger.sgml
26 MOD 61 0 完成 瀚高-韩悦悦 extend.sgml
27 MOD 34 18 完成 瀚高-韩悦悦 external-projects.sgml
28 MOD 45 0 完成 瀚高-韩悦悦 fdwhandler.sgml
29 MOD 47 0 完成 瀚高-韩悦悦 file-fdw.sgml
30 MOD 3 16 完成 ChenHuajun filelist.sgml
31 MOD 1087 44 完成 瀚高-韩悦悦 func.sgml
32 MOD 1 0 完成 瀚高-韩悦悦 generic-wal.sgml
33 MOD 38 304 完成 瀚高-韩悦悦 gin.sgml
34 MOD 137 8 完成 瀚高-韩悦悦 high-availability.sgml
35 MOD 89 0 完成 瀚高-韩悦悦 indexam.sgml
36 MOD 2 13 完成 瀚高-韩悦悦 indices.sgml
37 MOD 4 0 完成 瀚高-韩悦悦 info.sgml
38 MOD 31 2 完成 瀚高-韩悦悦 information_schema.sgml
39 MOD 22 127 完成 瀚高-韩悦悦 install-windows.sgml
40 MOD 116 209 完成 瀚高-韩悦悦 installation.sgml
41 MOD 1 0 完成 瀚高-韩悦悦 json.sgml
42 MOD 43 0 完成 瀚高-韩悦悦 keywords.sgml
43 MOD 284 19 完成 瀚高-韩悦悦 libpq.sgml
44 NEW 592 0 完成 瀚高-韩悦悦 logical-replication.sgml
45 MOD 67 13 完成 瀚高-韩悦悦 logicaldecoding.sgml
46 MOD 20 0 完成 瀚高-韩悦悦 maintenance.sgml
47 MOD 778 19 完成 瀚高-韩悦悦 monitoring.sgml
48 MOD 7 0 完成 瀚高-韩悦悦 mvcc.sgml
49 MOD 257 0 完成 瀚高-韩悦悦 pageinspect.sgml
50 MOD 167 7 完成 瀚高-韩悦悦 parallel.sgml
51 MOD 232 0 完成 瀚高-韩悦悦 perform.sgml
52 MOD 3 0 完成 瀚高-韩悦悦 pgbuffercache.sgml
53 MOD 6 12 完成 瀚高-韩悦悦 pgcrypto.sgml
54 MOD 3 0 完成 瀚高-韩悦悦 pgfreespacemap.sgml
55 MOD 7 0 完成 瀚高-韩悦悦 pgrowlocks.sgml
56 MOD 1 0 完成 瀚高-韩悦悦 pgstandby.sgml
57 MOD 26 0 完成 瀚高-韩悦悦 pgstatstatements.sgml
58 MOD 114 0 完成 瀚高-韩悦悦 pgstattuple.sgml
59 MOD 47 1 完成 瀚高-韩悦悦 pgvisibility.sgml
60 MOD 200 0 完成 瀚高-韩悦悦 planstats.sgml
61 MOD 1 0 完成 瀚高-韩悦悦 plhandler.sgml
62 MOD 2 1 完成 瀚高-韩悦悦 plperl.sgml
63 MOD 102 3 完成 瀚高-韩悦悦 plpgsql.sgml
64 MOD 50 14 完成 瀚高-韩悦悦 plpython.sgml
65 MOD 271 36 完成 瀚高-韩悦悦 pltcl.sgml
66 MOD 40 0 完成 瀚高-韩悦悦 postgres-fdw.sgml
67 MOD 2 1 完成 ChenHuajun postgres.sgml
68 MOD 1 0 完成 瀚高-韩悦悦 problems.sgml
69 MOD 1593 47 完成 瀚高-韩悦悦 protocol.sgml
70 MOD 10 2 完成 瀚高-韩悦悦 queries.sgml
71 MOD 1 0 完成 瀚高-韩悦悦 query.sgml
72 MOD 26 0 完成 瀚高-韩悦悦 recovery-config.sgml
73 MOD 12 2 完成 ChenHuajun ref/allfiles.sgml
74 MOD 1 1 完成 瀚高-韩悦悦 ref/alter_aggregate.sgml
75 MOD 56 0 完成 瀚高-韩悦悦 ref/alter_collation.sgml
76 MOD 4 0 完成 瀚高-韩悦悦 ref/alter_database.sgml
77 MOD 15 0 完成 瀚高-韩悦悦 ref/alter_default_privileges.sgml
78 MOD 8 0 完成 瀚高-韩悦悦 ref/alter_domain.sgml
79 MOD 2 0 完成 瀚高-韩悦悦 ref/alter_extension.sgml
80 MOD 7 0 完成 瀚高-韩悦悦 ref/alter_function.sgml
81 MOD 0 1 完成 瀚高-韩悦悦 ref/alter_materialized_view.sgml
82 MOD 4 0 完成 瀚高-韩悦悦 ref/alter_opfamily.sgml
83 MOD 6 0 完成 瀚高-韩悦悦 ref/alter_policy.sgml
84 NEW 165 0 完成 瀚高-韩悦悦 ref/alter_publication.sgml
85 MOD 5 2 完成 瀚高-韩悦悦 ref/alter_role.sgml
86 MOD 47 9 完成 瀚高-韩悦悦 ref/alter_sequence.sgml
87 NEW 117 0 完成 瀚高-韩悦悦 ref/alter_statistics.sgml
88 NEW 229 0 完成 瀚高-韩悦悦 ref/alter_subscription.sgml
89 MOD 1 1 完成 瀚高-韩悦悦 ref/alter_system.sgml
90 MOD 193 0 完成 瀚高-韩悦悦 ref/alter_table.sgml
91 MOD 9 0 完成 瀚高-韩悦悦 ref/alter_tablespace.sgml
92 MOD 47 8 完成 瀚高-韩悦悦 ref/alter_type.sgml
93 MOD 6 0 完成 瀚高-韩悦悦 ref/alter_user.sgml
94 MOD 5 0 完成 瀚高-韩悦悦 ref/analyze.sgml
95 MOD 7 0 完成 瀚高-韩悦悦 ref/comment.sgml
96 MOD 24 0 完成 瀚高-韩悦悦 ref/copy.sgml
97 MOD 1 1 完成 瀚高-韩悦悦 ref/create_access_method.sgml
98 MOD 4 0 完成 瀚高-韩悦悦 ref/create_cast.sgml
99 MOD 68 3 完成 瀚高-韩悦悦 ref/create_collation.sgml
100 MOD 25 1 完成 瀚高-韩悦悦 ref/create_database.sgml
101 MOD 26 0 完成 瀚高-韩悦悦 ref/create_foreign_table.sgml
102 MOD 8 1 完成 瀚高-韩悦悦 ref/create_function.sgml
103 MOD 1 0 完成 瀚高-韩悦悦 ref/create_group.sgml
104 MOD 14 13 完成 瀚高-韩悦悦 ref/create_index.sgml
105 MOD 3 9 完成 瀚高-韩悦悦 ref/create_language.sgml
106 MOD 5 0 完成 瀚高-韩悦悦 ref/create_opclass.sgml
107 MOD 162 21 完成 瀚高-韩悦悦 ref/create_policy.sgml
108 NEW 219 0 完成 瀚高-韩悦悦 ref/create_publication.sgml
109 MOD 33 2 完成 瀚高-韩悦悦 ref/create_role.sgml
110 MOD 1 0 完成 瀚高-韩悦悦 ref/create_schema.sgml
111 MOD 23 7 完成 瀚高-韩悦悦 ref/create_sequence.sgml
112 MOD 13 0 完成 瀚高-韩悦悦 ref/create_server.sgml
113 NEW 185 0 完成 瀚高-韩悦悦 ref/create_statistics.sgml
114 NEW 290 0 完成 瀚高-韩悦悦 ref/create_subscription.sgml
115 MOD 350 0 完成 瀚高-韩悦悦 ref/create_table.sgml
116 MOD 8 0 完成 瀚高-韩悦悦 ref/create_transform.sgml
117 MOD 153 3 完成 瀚高-韩悦悦 ref/create_trigger.sgml
118 MOD 1 0 完成 瀚高-韩悦悦 ref/create_type.sgml
119 MOD 1 0 完成 瀚高-韩悦悦 ref/create_user.sgml
120 MOD 13 0 完成 瀚高-韩悦悦 ref/create_user_mapping.sgml
121 MOD 14 0 完成 瀚高-韩悦悦 ref/create_view.sgml
122 MOD 4 0 完成 瀚高-韩悦悦 ref/createdb.sgml
123 MOD 3 15 完成 瀚高-韩悦悦 ref/createuser.sgml
124 MOD 9 1 完成 瀚高-韩悦悦 ref/delete.sgml
125 MOD 8 0 完成 瀚高-韩悦悦 ref/drop_aggregate.sgml
126 MOD 1 0 完成 瀚高-韩悦悦 ref/drop_foreign_data_wrapper.sgml
127 MOD 1 0 完成 瀚高-韩悦悦 ref/drop_foreign_table.sgml
128 MOD 37 0 完成 瀚高-韩悦悦 ref/drop_function.sgml
129 MOD 0 1 完成 瀚高-韩悦悦 ref/drop_language.sgml
130 MOD 7 0 完成 瀚高-韩悦悦 ref/drop_operator.sgml
131 MOD 1 1 完成 瀚高-韩悦悦 ref/drop_policy.sgml
132 NEW 105 0 完成 瀚高-韩悦悦 ref/drop_publication.sgml
133 MOD 1 0 完成 瀚高-韩悦悦 ref/drop_server.sgml
134 NEW 96 0 完成 瀚高-韩悦悦 ref/drop_statistics.sgml
135 NEW 130 0 完成 瀚高-韩悦悦 ref/drop_subscription.sgml
136 MOD 3 2 完成 瀚高-韩悦悦 ref/ecpg-ref.sgml
137 MOD 16 0 完成 瀚高-韩悦悦 ref/explain.sgml
138 MOD 40 1 完成 瀚高-韩悦悦 ref/grant.sgml
139 MOD 1 2 完成 瀚高-韩悦悦 ref/import_foreign_schema.sgml
140 MOD 17 0 完成 瀚高-韩悦悦 ref/initdb.sgml
141 MOD 58 1 完成 瀚高-韩悦悦 ref/insert.sgml
142 MOD 6 0 完成 瀚高-韩悦悦 ref/load.sgml
143 MOD 122 13 完成 瀚高-韩悦悦 ref/pg_basebackup.sgml
144 MOD 146 30 完成 瀚高-韩悦悦 ref/pg_ctl-ref.sgml
145 MOD 84 0 完成 瀚高-韩悦悦 ref/pg_dump.sgml
146 MOD 48 0 完成 瀚高-韩悦悦 ref/pg_dumpall.sgml
147 MOD 43 0 完成 瀚高-韩悦悦 ref/pg_receivewal.sgml
148 MOD 37 0 完成 瀚高-韩悦悦 ref/pg_recvlogical.sgml
149 MOD 32 0 完成 瀚高-韩悦悦 ref/pg_resetwal.sgml
150 MOD 39 0 完成 瀚高-韩悦悦 ref/pg_restore.sgml
151 MOD 3 0 完成 瀚高-韩悦悦 ref/pg_rewind.sgml
152 MOD 20 0 完成 瀚高-韩悦悦 ref/pg_waldump.sgml
153 MOD 68 2 完成 瀚高-韩悦悦 ref/pgbench.sgml
154 MOD 3 0 完成 瀚高-韩悦悦 ref/pgtestfsync.sgml
155 MOD 8 0 完成 瀚高-韩悦悦 ref/pgtesttiming.sgml
156 MOD 98 9 完成 瀚高-韩悦悦 ref/pgupgrade.sgml
157 MOD 1 0 完成 瀚高-韩悦悦 ref/prepare.sgml
158 MOD 2 0 完成 瀚高-韩悦悦 ref/prepare_transaction.sgml
159 MOD 437 31 完成 瀚高-韩悦悦 ref/psql-ref.sgml
160 MOD 2 0 完成 瀚高-韩悦悦 ref/reindexdb.sgml
161 MOD 1 0 完成 瀚高-韩悦悦 ref/revoke.sgml
162 MOD 3 0 完成 瀚高-韩悦悦 ref/security_label.sgml
163 MOD 5 0 完成 瀚高-韩悦悦 ref/select.sgml
164 MOD 3 0 完成 瀚高-韩悦悦 ref/set_transaction.sgml
165 MOD 8 0 完成 瀚高-韩悦悦 ref/truncate.sgml
166 MOD 15 0 完成 瀚高-韩悦悦 ref/update.sgml
167 MOD 6 28 完成 瀚高-韩悦悦 ref/vacuum.sgml
168 MOD 12 2 完成 ChenHuajun reference.sgml
169 MOD 16 2 完成 瀚高-韩悦悦 regress.sgml
170 NEW 4248 0 完成 瀚高-韩悦悦 release-10.sgml
171 MOD 134 0 完成 瀚高-韩悦悦 release-7.4.sgml
172 MOD 117 0 完成 瀚高-韩悦悦 release-8.0.sgml
173 MOD 105 0 完成 瀚高-韩悦悦 release-8.1.sgml
174 MOD 100 0 完成 瀚高-韩悦悦 release-8.2.sgml
175 MOD 100 0 完成 瀚高-韩悦悦 release-8.3.sgml
176 MOD 99 0 完成 瀚高-韩悦悦 release-8.4.sgml
177 MOD 101 0 完成 瀚高-韩悦悦 release-9.0.sgml
178 MOD 312 2 完成 瀚高-韩悦悦 release-9.1.sgml
179 MOD 3148 0 完成 瀚高-韩悦悦 release-9.2.sgml
180 MOD 3292 0 完成 瀚高-韩悦悦 release-9.3.sgml
181 MOD 3539 0 完成 瀚高-韩悦悦 release-9.4.sgml
182 MOD 3930 0 完成 瀚高-韩悦悦 release-9.5.sgml
183 MOD 5643 0 完成 瀚高-韩悦悦 release-9.6.sgml
184 MOD 253 0 完成 瀚高-韩悦悦 release-old.sgml
185 MOD 6 0 完成 ChenHuajun release.sgml
186 MOD 207 0 完成 瀚高-韩悦悦 rowtypes.sgml
187 MOD 1 0 完成 瀚高-韩悦悦 rules.sgml
188 MOD 222 59 完成 瀚高-韩悦悦 runtime.sgml
189 MOD 4 0 完成 瀚高-韩悦悦 sepgsql.sgml
190 MOD 6 0 完成 瀚高-韩悦悦 sourcerepo.sgml
191 MOD 1 0 完成 瀚高-韩悦悦 sources.sgml
192 MOD 46 5 完成 瀚高-韩悦悦 spgist.sgml
193 MOD 375 122 完成 瀚高-韩悦悦 spi.sgml
194 MOD 2 0 完成 瀚高-韩悦悦 sslinfo.sgml
195 MOD 15 5 完成 瀚高-韩悦悦 storage.sgml
196 MOD 32 1 完成 瀚高-韩悦悦 syntax.sgml
197 MOD 26 95 完成 瀚高-韩悦悦 textsearch.sgml
198 MOD 93 7 完成 瀚高-韩悦悦 trigger.sgml
199 MOD 49 0 完成 瀚高-韩悦悦 typeconv.sgml
200 MOD 36 0 完成 瀚高-韩悦悦 user-manag.sgml
201 MOD 1 0 完成 瀚高-韩悦悦 uuid-ossp.sgml
202 MOD 25 0 完成 瀚高-韩悦悦 wal.sgml
203 MOD 15 0 完成 瀚高-韩悦悦 xaggr.sgml
204 MOD 214 242 完成 瀚高-韩悦悦 xfunc.sgml
205 MOD 1 0 完成 瀚高-韩悦悦 xindex.sgml
206 MOD 5 0 完成 瀚高-韩悦悦 xml2.sgml
207 MOD 1 7 完成 瀚高-韩悦悦 xplang.sgml
41394 5482