Skip to content

pg12

Jump to bottom Edit New page
sizhitu edited this page Jun 8, 2020 · 74 revisions

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的步骤,可参考下面的例子。

在[翻译进度]中更新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 翻译中 ChenHuajun oid2name.sgml
47 MOD 36 23 翻译中 ChenHuajun 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 翻译中 jingsam 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 待翻译 zhangysh1995 ref/explain.sgml
99 MOD 26 278 完成 chegong18 ref/grant.sgml
100 MOD 15 0 完成 chegong18 ref/initdb.sgml
101 MOD 7 2 待翻译 zhangysh1995 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 待翻译 ref/psql-ref.sgml
121 MOD 5 0 待翻译 ref/reassign_owned.sgml
122 MOD 2 0 待翻译 ref/refresh_materialized_view.sgml
123 MOD 197 1 待翻译 ref/reindex.sgml
124 MOD 21 0 待翻译 ref/reindexdb.sgml
125 MOD 9 8 待翻译 ref/revoke.sgml
126 MOD 21 1 待翻译 ref/rollback.sgml
127 MOD 1 0 待翻译 ref/security_label.sgml
128 MOD 55 1 待翻译 ref/select.sgml
129 MOD 7 0 待翻译 ref/select_into.sgml
130 MOD 2 0 待翻译 ref/set_role.sgml
131 MOD 3 0 待翻译 ref/truncate.sgml
132 MOD 24 0 待翻译 ref/update.sgml
133 MOD 82 0 待翻译 ref/vacuum.sgml
134 MOD 95 0 待翻译 ref/vacuumdb.sgml
135 MOD 1 1 完成 ChenHuajun reference.sgml
136 MOD 97 2 待翻译 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 待翻译 release-12.sgml:1998-2988
138.4 NEW 1009 0 待翻译 release-12.sgml:2989-3998
138.5 NEW 990 0 待翻译 release-12.sgml:3999-4989
138.6 NEW 1520 0 待翻译 release-12.sgml:4990-6510
139 MOD 5 58 完成 ChenHuajun release.sgml
140 MOD 8 40 待翻译 rules.sgml
141 MOD 202 17 待翻译 runtime.sgml
142 MOD 29 0 待翻译 sources.sgml
143 MOD 61 0 待翻译 spgist.sgml
144 MOD 28 0 待翻译 spi.sgml
145 MOD 6 0 待翻译 sslinfo.sgml
146 MOD 35 0 待翻译 storage.sgml
147 NEW 111 0 完成 sunshinerxu tableam.sgml
148 MOD 5 1 待翻译 tablesample-method.sgml
149 MOD 28 8 待翻译 textsearch.sgml
150 MOD 27 0 待翻译 trigger.sgml
151 MOD 29 17 待翻译 user-manag.sgml
152 MOD 35 0 待翻译 vacuumlo.sgml
153 MOD 126 62 待翻译 xfunc.sgml
154 MOD 4 0 完成 messon007 xindex.sgml
155 MOD 13 0 待翻译 xoper.sgml
156 MOD 2 0 待翻译 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仓库删除，以方便翻译者参考，翻译完成可以删除。

Add a custom footer
Add a custom sidebar
Clone this wiki locally