Skip to content

pg10

Jump to bottom Edit New page
Chen Huajun edited this page Nov 18, 2017 · 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的源码

https://ftp.postgresql.org/pub/source/v10.1/postgresql-10.1.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 acronyms.sgml
2 MOD 1 0 adminpack.sgml
3 MOD 16 1 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 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
Add a custom footer
Add a custom sidebar
Clone this wiki locally