pg12
chegong18 edited this page Jul 18, 2020
·
74 revisions
本页面对PostgreSQL 12.2中文手册翻译的步骤和注意事项进行说明。
12.2的中文手册基于上一版的社区中文手册《PostgreSQL 11.2 中文手册》。
即初始master分支对应于11.2中文sgml(加上部分12.2新增英文原始sgml),翻译过程中逐步将12.2相对于11.2的更新内容翻译后反馈到github仓库。
https://github.com/postgres-cn/pgdoc-cn.git
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和11.2英文原始sgml找到变更点
- 翻译变更内容并合并到github的sgml文件中
- 更新英文原文注释(可选)
变更少的可以手动更新。大量变更的sgml，建议通过注释自动添加工具处理。先用使用注释自动添加工具删除之前的注释，再使用注释自动添加工重新添加注释。 中文手册全部翻译后，我们会对所有sgml全部使用自动注释工具重新生成一次注释，所以翻译者也可以省略更新注释的步骤。
github提交PR的步骤,可参考下面的例子。
编辑sgml文件时，请务必事先阅读翻译的注意点。
翻译状态:待翻译，翻译中，完成
对于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 | 完成 | chegong18 | oid2name.sgml |
| 47 | MOD | 36 | 23 | 完成 | chegong18 | 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 | 完成 | chegong18 | 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 | 完成 | ChenHuajun | ref/explain.sgml |
| 99 | MOD | 26 | 278 | 完成 | chegong18 | ref/grant.sgml |
| 100 | MOD | 15 | 0 | 完成 | chegong18 | ref/initdb.sgml |
| 101 | MOD | 7 | 2 | 完成 | ChenHuajun | 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 | 完成 | chegong18 | ref/psql-ref.sgml |
| 121 | MOD | 5 | 0 | 完成 | chegong18 | ref/reassign_owned.sgml |
| 122 | MOD | 2 | 0 | 完成 | chegong18 | ref/refresh_materialized_view.sgml |
| 123 | MOD | 197 | 1 | 完成 | chegong18 | ref/reindex.sgml |
| 124 | MOD | 21 | 0 | 完成 | chegong18 | ref/reindexdb.sgml |
| 125 | MOD | 9 | 8 | 完成 | chegong18 | ref/revoke.sgml |
| 126 | MOD | 21 | 1 | 完成 | chegong18 | ref/rollback.sgml |
| 127 | MOD | 1 | 0 | 完成 | chegong18 | ref/security_label.sgml |
| 128 | MOD | 55 | 1 | 完成 | chegong18 | ref/select.sgml |
| 129 | MOD | 7 | 0 | 完成 | chegong18 | ref/select_into.sgml |
| 130 | MOD | 2 | 0 | 完成 | chegong18 | ref/set_role.sgml |
| 131 | MOD | 3 | 0 | 完成 | chegong18 | ref/truncate.sgml |
| 132 | MOD | 24 | 0 | 完成 | chegong18 | ref/update.sgml |
| 133 | MOD | 82 | 0 | 完成 | chegong18 | ref/vacuum.sgml |
| 134 | MOD | 95 | 0 | 完成 | chegong18 | ref/vacuumdb.sgml |
| 135 | MOD | 1 | 1 | 完成 | ChenHuajun | reference.sgml |
| 136 | MOD | 97 | 2 | 完成 | chegong18 | 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 | 完成 | sizhitu | release-12.sgml:1998-2988 |
| 138.4 | NEW | 1009 | 0 | 完成 | sizhitu | release-12.sgml:2989-3998 |
| 138.5 | NEW | 990 | 0 | 完成 | sizhitu | release-12.sgml:3999-4989 |
| 138.6 | NEW | 1520 | 0 | 完成 | sizhitu | release-12.sgml:4990-6510 |
| 139 | MOD | 5 | 58 | 完成 | ChenHuajun | release.sgml |
| 140 | MOD | 8 | 40 | 完成 | chegong18 | rules.sgml |
| 141 | MOD | 202 | 17 | 完成 | chegong18 | runtime.sgml |
| 142 | MOD | 29 | 0 | 完成 | chegong18 | sources.sgml |
| 143 | MOD | 61 | 0 | 完成 | chegong18 | spgist.sgml |
| 144 | MOD | 28 | 0 | 完成 | chegong18 | spi.sgml |
| 145 | MOD | 6 | 0 | 完成 | chegong18 | sslinfo.sgml |
| 146 | MOD | 35 | 0 | 完成 | chegong18 | storage.sgml |
| 147 | NEW | 111 | 0 | 完成 | sunshinerxu | tableam.sgml |
| 148 | MOD | 5 | 1 | 完成 | chegong18 | tablesample-method.sgml |
| 149 | MOD | 28 | 8 | 完成 | chegong18 | textsearch.sgml |
| 150 | MOD | 27 | 0 | 完成 | chegong18 | trigger.sgml |
| 151 | MOD | 29 | 17 | 完成 | chegong18 | user-manag.sgml |
| 152 | MOD | 35 | 0 | 完成 | chegong18 | vacuumlo.sgml |
| 153 | MOD | 126 | 62 | 完成 | chegong18 | xfunc.sgml |
| 154 | MOD | 4 | 0 | 完成 | messon007 | xindex.sgml |
| 155 | MOD | 13 | 0 | 完成 | chegong18 | xoper.sgml |
| 156 | MOD | 2 | 0 | 完成 | chegong18 | 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仓库删除，以方便翻译者参考，翻译完成可以删除。