pg11
Chen Huajun edited this page Feb 2, 2020
·
70 revisions
本页面对PostgreSQL 11.2中文手册翻译的步骤和注意事项进行说明。
- 11.2的中文手册基于上一版的社区中文手册《PostgreSQL 10.1 中文手册》和彭老师翻译的11.0中文手册PostgreSQL 11.0 文档。
- 11.2相对于10.1新增和修改的sgml，大部分基于彭老师翻译的11.0并合并到11.2，其余少部分(11.0未翻译，或差异小于10行)保留11.2的英文sgml需要基于10.1翻译
- 11.2相对于10.1未修改的sgml保留当前的中文sgml
- 预先将所有sgml改成了符合xml规范的格式。
PostgreSQL 11中将所有sgml文件改成了符合xml格式规范的形式，这大大简化了sgml的文档编译。 因此从PG11开始，文档文件的扩展名虽然仍然是.sgml，但其内容已经是xml格式了。 为了保证sgml文档可以编译成功，也为了减少翻译人员的工作量，参考PG11的修改，已经预先将所有sgml改成了符合xml规范的格式。
sgml格式上主要的变更示例如下
例1:
<xref linkend="plpython-python23">
==>
<xref linkend="plpython-python23"/>
例2:
<productname>PostgreSQL</>
==>
<productname>PostgreSQL</productname>
例3:
class="PARAMETER"
==>
class="parameter"
例4:
&
==>
&
例5:
<
==>
<
例6:
删掉 <![IGNORE[ ...]]>
例7:
<![%standalone-ignore[<xref linkend="plpython-python23">]]>
=>
<xref linkend="plpython-python23"/>
https://github.com/postgres-cn/pgdoc-cn.git
https://ftp.postgresql.org/pub/source/v11.2/postgresql-11.2.tar.gz
- https://pan.baidu.com/s/1R0gUiiAQzr63YlpmnNk3qA （提取码djia）
为了在对比11.2的sgml相对10.1做的变更时，排除sgml->xml大量格式变更带来的干扰，务必使用预处理过的10.1的sgml。这些sgml相对于原始10.1的sgml，预先处理了上面的例1，例2和例3 三种类型的格式变更。
在预定的sgml的翻译者栏填上自己的名字，并将翻译状态改为"翻译中"
- 翻译sgml
- 使用注释自动添加工具添加注释
关于注释自动添加工具的使用，参考翻译的注意点
- 对比11.2源码中的英文原始sgml和预处理过的10.1英文原始sgml(即上面的postgresql-10.1_std.tar.gz)找到变更点
- 翻译变更内容并合并到github的sgml文件中
- 更新英文原文注释
变更少的可以手动更新。大量变更的sgml，建议通过注释自动添加工具处理。先用使用注释自动添加工具删除之前的注释，再使用注释自动添加工重新添加注释
github提交PR的步骤,可参考下面的例子。
编辑sgml文件时，请务必事先阅读翻译的注意点。
翻译状态:待翻译，翻译中，完成
以下"已合并"的sgml，基于彭老师的11.0中文手册，并且已经合并到11.2。其余sgml基于10.1_std中文版翻译升级到11.2。
| NO | 修改类型 | A&M | DEL | 翻译状态 | 翻译者 | sgml |
|---|---|---|---|---|---|---|
| 1 | MOD | 71 | 0 | 已合并 | acronyms.sgml | |
| 2 | MOD | 6 | 46 | 已合并 | adminpack.sgml | |
| 3 | MOD | 102 | 3 | 已合并 | amcheck.sgml | |
| 4 | MOD | 6 | 22 | 已合并 | array.sgml | |
| 5 | MOD | 15 | 0 | 已合并 | backup.sgml | |
| 6 | MOD | 28 | 0 | 已合并 | bgworker.sgml | |
| 7 | MOD | 635 | 0 | 已合并 | bki.sgml | |
| 8 | MOD | 18 | 0 | 已合并 | bloom.sgml | |
| 9 | MOD | 39 | 0 | 已合并 | brin.sgml | |
| 10 | MOD | 2 | 0 | 完成 | Steve888888 | btree-gin.sgml |
| 11 | NEW | 443 | 0 | 已合并 | btree.sgml | |
| 12 | MOD | 173 | 16 | 已合并 | catalogs.sgml | |
| 13 | MOD | 13 | 1 | 完成 | Steve888888 | charset.sgml |
| 14 | MOD | 5 | 0 | 完成 | Steve888888 | citext.sgml |
| 15 | MOD | 104 | 2 | 已合并 | client-auth.sgml | |
| 16 | MOD | 735 | 149 | 已合并 | config.sgml | |
| 17 | MOD | 3 | 0 | 完成 | Steve888888 | contrib-spi.sgml |
| 18 | MOD | 1 | 1 | 完成 | ChenHuajun | contrib.sgml |
| 19 | MOD | 6 | 0 | 完成 | Steve888888 | cube.sgml |
| 20 | MOD | 3 | 0 | 完成 | Steve888888 | custom-scan.sgml |
| 21 | MOD | 168 | 37 | 已合并 | datatype.sgml | |
| 22 | MOD | 84 | 0 | 已合并 | datetime.sgml | |
| 23 | MOD | 44 | 0 | 已合并 | dblink.sgml | |
| 24 | MOD | 417 | 23 | 已合并 | ddl.sgml | |
| 25 | MOD | 1 | 0 | 完成 | ChenHuajun | dml.sgml |
| 26 | MOD | 49 | 260 | 已合并 | docguide.sgml | |
| 27 | MOD | 99 | 4 | 已合并 | ecpg.sgml | |
| 28 | MOD | 21 | 0 | 已合并 | event-trigger.sgml | |
| 29 | MOD | 169 | 13 | 已合并 | extend.sgml | |
| 30 | MOD | 4 | 0 | 完成 | Steve888888 | external-projects.sgml |
| 31 | MOD | 190 | 0 | 已合并 | fdwhandler.sgml | |
| 32 | MOD | 5 | 0 | 完成 | Steve888888 | file-fdw.sgml |
| 33 | MOD | 3 | 25 | 完成 | ChenHuajun | filelist.sgml |
| 34 | MOD | 369 | 14 | 已合并 | func.sgml | |
| 35 | MOD | 4 | 0 | 完成 | Steve888888 | fuzzystrmatch.sgml |
| 36 | MOD | 15 | 0 | 已合并 | gin.sgml | |
| 37 | MOD | 25 | 0 | 已合并 | gist.sgml | |
| 38 | MOD | 27 | 1 | 已合并 | high-availability.sgml | |
| 39 | MOD | 9 | 0 | 完成 | Steve888888 | history.sgml |
| 40 | MOD | 39 | 0 | 已合并 | indexam.sgml | |
| 41 | MOD | 257 | 177 | 完成 | Steve888888 | indices.sgml |
| 42 | MOD | 31 | 0 | 已合并 | information_schema.sgml | |
| 43 | MOD | 10 | 0 | 完成 | Steve888888 | install-windows.sgml |
| 44 | MOD | 185 | 197 | 已合并 | installation.sgml | |
| 45 | MOD | 7 | 0 | 完成 | Steve888888 | isn.sgml |
| 46 | NEW | 285 | 0 | 已合并 | jit.sgml | |
| 47 | MOD | 24 | 0 | 已合并 | json.sgml | |
| 48 | MOD | 26 | 1 | 已合并 | keywords.sgml | |
| 49 | MOD | 349 | 33 | 已合并 | libpq.sgml | |
| 50 | MOD | 2 | 0 | 完成 | ChenHuajun | lo.sgml |
| 51 | MOD | 53 | 0 | 已合并 | lobj.sgml | |
| 52 | MOD | 29 | 0 | 已合并 | logical-replication.sgml | |
| 53 | MOD | 43 | 0 | 已合并 | logicaldecoding.sgml | |
| 54 | MOD | 5 | 2 | 完成 | Steve888888 | ltree.sgml |
| 55 | MOD | 1 | 0 | 完成 | Steve888888 | maintenance.sgml |
| 56 | MOD | 125 | 8 | 已合并 | monitoring.sgml | |
| 57 | MOD | 1 | 0 | 完成 | ChenHuajun | nls.sgml |
| 58 | MOD | 10 | 1 | 已合并 | pageinspect.sgml | |
| 59 | MOD | 92 | 10 | 已合并 | parallel.sgml | |
| 60 | MOD | 3 | 0 | 完成 | ChenHuajun | passwordcheck.sgml |
| 61 | MOD | 18 | 0 | 已合并 | perform.sgml | |
| 62 | MOD | 9 | 4 | 已合并 | pgcrypto.sgml | |
| 63 | MOD | 68 | 0 | 已合并 | pgprewarm.sgml | |
| 64 | MOD | 9 | 0 | 完成 | Steve888888 | pgrowlocks.sgml |
| 65 | MOD | 8 | 0 | 完成 | Steve888888 | pgstattuple.sgml |
| 66 | MOD | 131 | 0 | 已合并 | pgtrgm.sgml | |
| 67 | MOD | 3 | 3 | 完成 | Steve888888 | plhandler.sgml |
| 68 | MOD | 70 | 0 | 已合并 | plperl.sgml | |
| 69 | MOD | 224 | 90 | 已合并 | plpgsql.sgml | |
| 70 | MOD | 64 | 0 | 已合并 | plpython.sgml | |
| 71 | MOD | 78 | 0 | 已合并 | pltcl.sgml | |
| 72 | MOD | 5 | 0 | 完成 | ChenHuajun | postgres.sgml |
| 73 | MOD | 12 | 4 | 已合并 | problems.sgml | |
| 74 | MOD | 376 | 0 | 已合并 | protocol.sgml | |
| 75 | MOD | 41 | 0 | 已合并 | queries.sgml | |
| 76 | MOD | 7 | 0 | 完成 | ChenHuajun | ref/allfiles.sgml |
| 77 | MOD | 10 | 0 | 完成 | jingsam | ref/alter_default_privileges.sgml |
| 78 | MOD | 10 | 0 | 完成 | jingsam | ref/alter_domain.sgml |
| 79 | MOD | 10 | 0 | 完成 | jingsam | ref/alter_extension.sgml |
| 80 | MOD | 3 | 0 | 完成 | jingsam | ref/alter_function.sgml |
| 81 | MOD | 60 | 0 | 已合并 | ref/alter_index.sgml | |
| 82 | MOD | 10 | 0 | 完成 | Steve888888 | ref/alter_large_object.sgml |
| 83 | MOD | 3 | 0 | 完成 | jingsam | ref/alter_operator.sgml |
| 84 | MOD | 3 | 0 | 完成 | jingsam | ref/alter_opfamily.sgml |
| 85 | NEW | 281 | 0 | 已合并 | ref/alter_procedure.sgml | |
| 86 | MOD | 11 | 0 | 已合并 | ref/alter_role.sgml | |
| 87 | NEW | 102 | 0 | 已合并 | ref/alter_routine.sgml | |
| 88 | MOD | 175 | 1 | 已合并 | ref/alter_table.sgml | |
| 89 | MOD | 2 | 0 | 完成 | Steve888888 | ref/alter_user.sgml |
| 90 | MOD | 23 | 0 | 已合并 | ref/analyze.sgml | |
| 91 | NEW | 115 | 0 | 已合并 | ref/call.sgml | |
| 92 | MOD | 10 | 0 | 完成 | ChenHuajun | ref/comment.sgml |
| 93 | MOD | 14 | 0 | 已合并 | ref/copy.sgml | |
| 94 | MOD | 68 | 0 | 完成 | Steve888888 | ref/create_aggregate.sgml |
| 95 | MOD | 11 | 0 | 已合并 | ref/create_event_trigger.sgml | |
| 96 | MOD | 15 | 37 | 已合并 | ref/create_function.sgml | |
| 97 | MOD | 183 | 0 | 已合并 | ref/create_index.sgml | |
| 98 | MOD | 2 | 0 | 完成 | ChenHuajun | ref/create_language.sgml |
| 99 | MOD | 4 | 0 | 完成 | ChenHuajun | ref/create_opclass.sgml |
| 100 | MOD | 14 | 0 | 已合并 | ref/create_operator.sgml | |
| 101 | MOD | 107 | 1 | 已合并 | ref/create_policy.sgml | |
| 102 | NEW | 357 | 0 | 已合并 | ref/create_procedure.sgml | |
| 103 | MOD | 6 | 1 | 完成 | chegong18 | ref/create_publication.sgml |
| 104 | MOD | 11 | 0 | 已合并 | ref/create_role.sgml | |
| 105 | MOD | 2 | 0 | 完成 | jingsam | ref/create_server.sgml |
| 106 | MOD | 4 | 0 | 完成 | ChenHuajun | ref/create_statistics.sgml |
| 107 | MOD | 3 | 0 | 完成 | Steve888888 | ref/create_subscription.sgml |
| 108 | MOD | 347 | 127 | 完成 | chegong18 | ref/create_table.sgml |
| 109 | MOD | 3 | 0 | 完成 | chegong18 | ref/create_transform.sgml |
| 110 | MOD | 55 | 0 | 已合并 | ref/create_trigger.sgml | |
| 111 | MOD | 11 | 0 | 已合并 | ref/create_type.sgml | |
| 112 | MOD | 2 | 0 | 完成 | Steve888888 | ref/create_user.sgml |
| 113 | MOD | 2 | 0 | 完成 | ChenHuajun | ref/create_user_mapping.sgml |
| 114 | MOD | 12 | 0 | 已合并 | ref/create_view.sgml | |
| 115 | MOD | 3 | 0 | 完成 | ChenHuajun | ref/declare.sgml |
| 116 | MOD | 9 | 0 | 完成 | Steve888888 | ref/do.sgml |
| 117 | MOD | 5 | 0 | 完成 | Steve888888 | ref/drop_function.sgml |
| 118 | NEW | 162 | 0 | 已合并 | ref/drop_procedure.sgml | |
| 119 | NEW | 94 | 0 | 已合并 | ref/drop_routine.sgml | |
| 120 | MOD | 4 | 0 | 完成 | Steve888888 | ref/ecpg-ref.sgml |
| 121 | MOD | 2 | 0 | 已合并 | sizhitu | ref/fetch.sgml |
| 122 | MOD | 17 | 0 | 已合并 | ref/grant.sgml | |
| 123 | MOD | 44 | 0 | 已合并 | ref/initdb.sgml | |
| 124 | MOD | 12 | 0 | 已合并 | ref/insert.sgml | |
| 125 | MOD | 14 | 0 | 已合并 | ref/lock.sgml | |
| 126 | MOD | 95 | 42 | 已合并 | ref/pg_basebackup.sgml | |
| 127 | MOD | 9 | 0 | 完成 | chegong18 | ref/pg_controldata.sgml |
| 128 | MOD | 13 | 1 | 已合并 | ref/pg_ctl-ref.sgml | |
| 129 | MOD | 69 | 4 | 已合并 | ref/pg_dump.sgml | |
| 130 | MOD | 82 | 3 | 已合并 | ref/pg_dumpall.sgml | |
| 131 | MOD | 58 | 0 | 已合并 | ref/pg_receivewal.sgml | |
| 132 | MOD | 12 | 0 | 已合并 | ref/pg_recvlogical.sgml | |
| 133 | MOD | 67 | 0 | 已合并 | ref/pg_resetwal.sgml | |
| 134 | MOD | 28 | 0 | 已合并 | ref/pg_restore.sgml | |
| 135 | MOD | 33 | 0 | 已合并 | ref/pg_rewind.sgml | |
| 136 | NEW | 122 | 0 | 已合并 | ref/pg_verify_checksums.sgml | |
| 137 | MOD | 476 | 1 | 已合并 | ref/pgbench.sgml | |
| 138 | MOD | 6 | 0 | 完成 | chegong18 | ref/pgtesttiming.sgml |
| 139 | MOD | 19 | 0 | 已合并 | ref/pgupgrade.sgml | |
| 140 | MOD | 4 | 0 | 完成 | chegong18 | ref/prepare.sgml |
| 141 | MOD | 4 | 0 | 完成 | chegong18 | ref/prepare_transaction.sgml |
| 142 | MOD | 273 | 19 | 已合并 | ref/psql-ref.sgml | |
| 143 | MOD | 4 | 0 | 完成 | chegong18 | ref/refresh_materialized_view.sgml |
| 144 | MOD | 15 | 0 | 已合并 | ref/reindex.sgml | |
| 145 | MOD | 8 | 0 | 完成 | chegong18 | ref/revoke.sgml |
| 146 | MOD | 9 | 0 | 完成 | ChenHuajun | ref/security_label.sgml |
| 147 | MOD | 97 | 11 | 已合并 | ref/select.sgml | |
| 148 | MOD | 13 | 0 | 已合并 | ref/update.sgml | |
| 149 | MOD | 25 | 1 | 已合并 | ref/vacuum.sgml | |
| 150 | MOD | 7 | 0 | 完成 | ChenHuajun | reference.sgml |
| 151 | MOD | 72 | 0 | 已合并 | regress.sgml | |
| 152 | MOD | 83 | 0 | 完成 | ChenHuajun | release.sgml |
| 153 | MOD | 19 | 0 | 已合并 | rowtypes.sgml | |
| 154 | MOD | 10 | 1 | 已合并 | rules.sgml | |
| 155 | MOD | 245 | 70 | 已合并 | sizhitu | runtime.sgml |
| 156 | MOD | 1 | 0 | 完成 | ChenHuajun | sepgsql.sgml |
| 157 | MOD | 6 | 3 | 完成 | ChenHuajun | sourcerepo.sgml |
| 158 | MOD | 18 | 0 | 已合并 | sources.sgml | |
| 159 | MOD | 94 | 0 | 已合并 | spgist.sgml | |
| 160 | MOD | 276 | 16 | 已合并 | spi.sgml | |
| 161 | MOD | 4 | 0 | 完成 | ChenHuajun | sslinfo.sgml |
| 162 | MOD | 12 | 1 | 已合并 | storage.sgml | |
| 163 | MOD | 122 | 2 | 已合并 | syntax.sgml | |
| 164 | MOD | 1 | 0 | 完成 | ChenHuajun | tcn.sgml |
| 165 | MOD | 1 | 0 | 完成 | ChenHuajun | test-decoding.sgml |
| 166 | MOD | 94 | 0 | 已合并 | textsearch.sgml | |
| 167 | MOD | 34 | 0 | 已合并 | trigger.sgml | |
| 168 | MOD | 129 | 0 | 已合并 | typeconv.sgml | |
| 169 | MOD | 4 | 0 | 完成 | Steve888888 | unaccent.sgml |
| 170 | MOD | 37 | 0 | 已合并 | user-manag.sgml | |
| 171 | MOD | 9 | 1 | 完成 | Steve888888 | wal.sgml |
| 172 | MOD | 13 | 1 | 已合并 | xaggr.sgml | |
| 173 | MOD | 88 | 11 | 已合并 | xfunc.sgml | |
| 174 | MOD | 100 | 9 | 已合并 | xindex.sgml | |
| 175 | MOD | 1 | 0 | 完成 | ChenHuajun | xml2.sgml |
| 176 | MOD | 17 | 9 | 已合并 | xoper.sgml | |
| 177 | MOD | 2 | 0 | 完成 | ChenHuajun | xplang.sgml |
| 178 | NEW | 5368 | 0 | 完成 | sunshinerxu | release-11.sgml |
| 17646 | 1250 |