Skip to content

pg15

Jump to bottom Edit New page
songjinzhou edited this page Nov 7, 2024 · 113 revisions

PostgreSQL 15.7中文手册的翻译

PostgreSQL 15.7手册通过AI大模型+人工校对的形式翻译。初始版本是AI大模型的翻译后的结果，本页说明人工校对的步骤。

1. 15.7的翻译基线

15.7的中文手册基于上一版的社区中文手册《PostgreSQL 14.1 中文手册》。

即只翻译15.7手册相对于14.1中变更的部分，不变的部分沿用14.1中文手册中的内容。

2. 翻译过程介绍

基于以下原因，我们从sgml文件中提取出若干需要翻译的片段，对这些片段单独翻译

  • 方便差分翻译，识别出新版本文档中发生变化的片段，最大程度复用历史翻译资产
  • 方便使用AI大模型翻译。AI单次处理的token有长度限制，。
  • 方便人工校对时和英文原文对照

下面是一个翻译后sgml片段的示例:

<!-- pgdoc-cn_start sig_en=a3c9497e6f6fa1a8db2b18fe9e8b9adc sig_cn_org=ab103fcfada97634f0619e415f18bf6b source=15.7 
       <para>
        This option relies on kernel events exposed by Linux, macOS, illumos
        and the BSD family of operating systems, and is not currently available
        on other systems.
       </para>
________________________________________________________-->
       <para>
        这个选项依赖于Linux、macOS、illumos和BSD家族操作系统暴露的内核事件，
        目前在其他系统上不可用。
       </para>
<!-- pgdoc-cn_end sig_en=a3c9497e6f6fa1a8db2b18fe9e8b9adc -->

解释：

  • sig_en:英文原文片段（去除前后两端的空白字符）的md5摘要，是片段唯一标识
  • sig_cn_org:AI大模型初始翻译内容的md5摘要，通过对比这个值和当前中文译文的摘要可以判断译文是否被人工修改过。继承自14.1的译文是人工翻译的，这个值是None
  • source：译文来源自哪个版本的翻译。比如本次AI翻译的片段，source=15.7

3. 校对步骤

clone自己的git仓库

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

在下面的[翻译进度]预定要校对的sgml

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

下载校对用的单一html文件并解压

http://postgres.cn/docs/check/postgres_check_15.7.zip

实施校对

用浏览器打开这个html，并搜索关键字pgdoc_cn_new_tag_xxxxx，xxxxx替换成需要校对的sgml文件名，找到本次AI新翻译的内容。 比如对于func.sgml,可通过pgdoc_cn_new_tag_func关键字，查找待校对片段。

       <p>
        $pgdoc_cn_new_tag_func[[$绝对值
       </p>
       <p>
        <code class="literal">@ -5.0</code>
        → <code class="returnvalue">5.0$]]pgdoc_cn_new_tag_func$</code>

校对后，对翻译有误的地方，修改github中对应sgml文件并提交。

必要时可以对照社区官网英文文档（ https://www.postgresql.org/docs/15/index.html ）。

另外，也可以直接在sgml文件中搜索关键字"source=15.7"，找到本次AI翻译的片段，但是，这种方式不能很直观的看到页面的最终显示效果。

创建PR将修改好的sgml提交到git仓库

github提交PR的步骤,如果不了解github使用步骤,可参考下面的例子。

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

4. 翻译的注意点

编辑sgml文件时，请务必事先阅读翻译的注意点。

5. 翻译进度

翻译状态:待校对，校对中，待合并，完成

NO 文件字符 总片段 总字符 新翻译片段 新翻译字符 翻译状态 翻译者 SGML文件
1 47384 81 9931 80 9908 完成 林甲良 acronyms.sgml
2 14672 21 5598 1 583 完成 林甲良 adminpack.sgml
3 54267 63 25678 4 3505 完成 林甲良 advanced.sgml
4 44839 48 21139 2 885 完成 林甲良 amcheck.sgml
5 47926 52 24154 4 2838 完成 林甲良 arch-dev.sgml
6 12141 17 4857 17 4857 完成 林甲良 archive-modules.sgml
7 4940 11 1380 1 216 完成 林甲良 auth-delay.sgml
8 130800 124 68516 25 16381 完成 林甲良 backup.sgml
9 7380 11 2708 9 2648 完成 林甲良 basebackup-to-shell.sgml
10 6846 13 2058 10 1882 完成 林甲良 basic-archive.sgml
11 28981 25 14620 2 1768 完成 林甲良 bgworker.sgml
12 36689 29 15298 1 244 完成 林甲良 biblio.sgml
13 84730 89 39196 4 2103 完成 林甲良 bki.sgml
14 24316 29 10657 4 5693 完成 林甲良 bloom.sgml
15 90655 98 25658 9 3843 完成 林甲良 brin.sgml
16 10587 14 4234 1 790 完成 林甲良 btree-gist.sgml
17 75219 68 38316 1 1273 校对中 messon007 btree.sgml
18 793635 1011 309862 68 27304 完成 林甲良 catalogs.sgml
19 197596 198 76761 16 11705 完成 林甲良 charset.sgml
20 186012 179 88847 59 34119 完成 林甲良 client-auth.sgml
21 7303 10 2882 2 1246 完成 林甲良 color.sgml
22 1038094 1239 442139 144 68505 完成 林甲良 config.sgml
23 8194 7 3908 7 3908 完成 林甲良 custom-rmgr.sgml
24 35903 35 17311 2 2467 完成 林甲良 custom-scan.sgml
25 460424 671 182094 26 20151 完成 林甲良 datatype.sgml
26 73813 105 31350 2 1513 完成 林甲良 datetime.sgml
27 147724 263 47198 2 2600 完成 林甲良 dblink.sgml
28 400563 440 191354 55 36951 完成 林甲良 ddl.sgml
29 43820 51 19927 9 5401 完成 林甲良 docguide.sgml
30 21063 30 8504 1 442 完成 林甲良 earthdistance.sgml
31 685280 740 287191 161 53045 chegong18 待领取 ecpg.sgml
32 75541 40 15412 1 667 校对中 chegong18 event-trigger.sgml
33 156976 163 75598 2 956 校对中 chegong18 extend.sgml
34 10158 15 3985 2 1709 校对中 chegong18 external-projects.sgml
35 193509 194 95978 1 1194 校对中 chegong18 fdwhandler.sgml
36 2308487 2151 1006971 220 129189 完成 林甲良 func.sgml
37 11396 8 6155 3 733 完成 songjinzhou generic-wal.sgml
38 154535 209 55668 22 8080 完成 songjinzhou glossary.sgml
39 13311 20 6565 2 1107 完成 songjinzhou hash.sgml
40 201715 232 98573 21 18552 校对中 messon007 high-availability.sgml
41 16807 16 8223 1 388 完成 songjinzhou history.sgml
42 75499 82 31266 4 1951 完成 songjinzhou hstore.sgml
43 125119 99 67049 2 2097 完成 songjinzhou indexam.sgml
44 134478 150 66572 7 4073 完成 songjinzhou indices.sgml
45 683002 880 264179 6 3956 完成 songjinzhou information_schema.sgml
46 48024 50 21160 26 11942 完成 songjinzhou install-windows.sgml
47 202085 243 84416 42 13144 完成 songjinzhou installation.sgml
48 40646 52 16011 1 681 完成 songjinzhou intarray.sgml
49 83575 84 40289 8 9647 待校对 yanquanle json.sgml
50 717955 637 328575 178 87334 完成 songjinzhou libpq.sgml
51 10992 20 3786 6 1595 完成 songjinzhou limits.sgml
52 11510 21 4372 1 658 完成 songjinzhou lo.sgml
53 67327 76 26976 3 1909 完成 songjinzhou lobj.sgml
54 132012 151 60970 85 38206 完成 songjinzhou logical-replication.sgml
55 126528 130 58283 9 13776 完成 songjinzhou logicaldecoding.sgml
56 73618 88 29515 3 1149 待校对 yanquanle ltree.sgml
57 109723 103 57440 17 16193 完成 林甲良 maintenance.sgml
58 48789 57 23494 3 1906 完成 林甲良 manage-ag.sgml
59 664191 940 254247 70 27577 完成 林甲良 monitoring.sgml
60 158240 171 76660 27 13614 校对中 messon007 mvcc.sgml
61 2686 4 1147 1 473 完成 songjinzhou notation.sgml
62 77138 80 32403 13 8833 完成 songjinzhou pageinspect.sgml
63 51255 57 26021 3 2938 完成 songjinzhou parallel.sgml
64 176746 142 94367 6 6624 完成 songjinzhou perform.sgml
65 18028 28 6442 1 198 校对中 messon007 pgbuffercache.sgml
66 98397 200 29585 5 1163 完成 songjinzhou pgcrypto.sgml
67 8202 14 2698 6 1866 完成 songjinzhou pgfreespacemap.sgml
68 12593 21 4749 3 511 完成 songjinzhou pgprewarm.sgml
69 12501 24 3985 1 206 完成 songjinzhou pgrowlocks.sgml
70 85821 93 37624 23 14271 完成 songjinzhou pgstatstatements.sgml
71 6306 8 2439 2 1637 完成 songjinzhou pgsurgery.sgml
72 11500 17 4040 1 299 完成 songjinzhou pgvisibility.sgml
73 14327 15 5647 13 5594 完成 songjinzhou pgwalinspect.sgml
74 65072 37 36090 4 7555 完成 songjinzhou planstats.sgml
75 17696 15 9917 1 1447 完成 songjinzhou plhandler.sgml
76 118671 121 52511 7 6502 完成 songjinzhou plperl.sgml
77 468657 475 214949 11 13862 校对中 wangyong plpgsql.sgml
78 96494 82 45514 27 25487 完成 林甲良 plpython.sgml
79 89656 89 41867 19 10993 完成 林甲良 pltcl.sgml
80 97694 128 42750 42 11694 完成 林甲良 postgres-fdw.sgml
81 606863 1092 183566 950 118618 完成 songjinzhou protocol.sgml
82 218948 228 102249 6 3252 完成 songjinzhou queries.sgml
83 65571 60 32462 2 2961 完成 songjinzhou query.sgml
84 15617 25 5370 4 2268 完成 songjinzhou ref/alter_collation.sgml
85 18547 29 6137 2 1619 完成 songjinzhou ref/alter_database.sgml
86 20064 22 8341 2 2930 完成 songjinzhou ref/alter_default_privileges.sgml
87 7460 15 1673 1 86 完成 songjinzhou ref/alter_event_trigger.sgml
88 13810 23 4070 1 239 完成 songjinzhou ref/alter_foreign_data_wrapper.sgml
89 40746 35 17407 1 189 完成 songjinzhou ref/alter_foreign_table.sgml
90 29040 37 10111 1 457 完成 songjinzhou ref/alter_function.sgml
91 15485 20 5175 1 2637 完成 songjinzhou ref/alter_materialized_view.sgml
92 22287 29 8010 1 440 完成 songjinzhou ref/alter_procedure.sgml
93 20001 28 7047 11 5139 完成 songjinzhou ref/alter_publication.sgml
94 28279 38 10186 1 166 完成 songjinzhou ref/alter_role.sgml
95 28660 36 10547 19 7658 完成 songjinzhou ref/alter_sequence.sgml
96 25725 28 9943 12 7621 完成 songjinzhou ref/alter_subscription.sgml
97 11630 20 3803 4 1309 完成 songjinzhou ref/alter_system.sgml
98 156296 162 67465 86 49056 完成 songjinzhou ref/alter_table.sgml
99 10382 21 2755 3 601 完成 songjinzhou ref/alter_trigger.sgml
100 33641 23 16239 1 726 完成 songjinzhou ref/alter_type.sgml
101 17271 25 5645 1 1200 完成 songjinzhou ref/alter_view.sgml
102 26104 34 11519 4 1775 完成 songjinzhou ref/analyze.sgml
103 4999 10 1490 1 201 完成 songjinzhou ref/checkpoint.sgml
104 20445 32 7690 1 216 完成 songjinzhou ref/cluster.sgml
105 32752 32 13052 5 8411 完成 songjinzhou ref/comment.sgml
106 88837 100 39465 3 2897 完成 songjinzhou ref/copy.sgml
107 27623 36 8982 16 2347 完成 songjinzhou ref/createdb.sgml
108 32627 42 10931 23 4260 完成 songjinzhou ref/createuser.sgml
109 17914 30 5811 1 621 完成 songjinzhou ref/create_collation.sgml
110 35466 47 13799 9 4278 完成 songjinzhou ref/create_database.sgml
111 20622 31 7706 2 981 完成 songjinzhou ref/create_domain.sgml
112 36012 45 14244 5 4514 完成 songjinzhou ref/create_foreign_table.sgml
113 81464 106 34229 8 4958 完成 songjinzhou ref/create_index.sgml
114 13393 19 4431 1 273 完成 songjinzhou ref/create_materialized_view.sgml
115 21297 33 7124 1 1245 完成 songjinzhou ref/create_operator.sgml
116 53086 58 23438 7 3954 完成 songjinzhou ref/create_policy.sgml
117 33270 47 13283 24 9705 完成 songjinzhou ref/create_publication.sgml
118 38934 49 15565 1 417 完成 songjinzhou ref/create_role.sgml
119 23876 29 9898 1 728 完成 songjinzhou ref/create_rule.sgml
120 31181 41 12406 5 3057 完成 songjinzhou ref/create_sequence.sgml
121 11952 23 3160 1 143 完成 songjinzhou ref/create_server.sgml
122 23504 25 10489 2 488 完成 songjinzhou ref/create_statistics.sgml
123 34472 46 13597 28 10469 完成 songjinzhou ref/create_subscription.sgml
124 205610 229 90800 16 17395 完成 songjinzhou ref/create_table.sgml
125 24272 32 8760 1 156 完成 songjinzhou ref/create_table_as.sgml
126 15285 22 5609 1 857 完成 songjinzhou ref/create_transform.sgml
127 61666 71 27320 1 991 完成 songjinzhou ref/create_trigger.sgml
128 46609 49 21220 11 6668 完成 songjinzhou ref/create_view.sgml
129 8000 16 2039 2 592 完成 songjinzhou ref/drop_extension.sgml
130 8622 18 2363 1 328 完成 songjinzhou ref/drop_owned.sgml
131 16011 24 5558 1 725 完成 songjinzhou ref/drop_procedure.sgml
132 9342 18 2810 1 1344 完成 songjinzhou ref/drop_subscription.sgml
133 7872 17 1678 1 196 完成 songjinzhou ref/drop_transform.sgml
134 18436 27 6102 13 3621 完成 songjinzhou ref/ecpg-ref.sgml
135 36860 40 16678 5 4414 完成 songjinzhou ref/explain.sgml
136 29541 28 12796 1 667 完成 songjinzhou ref/fetch.sgml
137 42828 44 19297 5 8262 完成 songjinzhou ref/grant.sgml
138 40930 49 15102 30 9720 完成 songjinzhou ref/initdb.sgml
139 66535 75 28005 5 2840 完成 songjinzhou ref/insert.sgml
140 22305 27 9707 1 652 完成 songjinzhou ref/lock.sgml
141 51764 55 21983 49 21839 完成 songjinzhou ref/merge.sgml
142 8291 14 2596 1 666 完成 songjinzhou ref/move.sgml
143 224669 231 93339 97 41040 完成 songjinzhou ref/pgbench.sgml
144 70554 99 27241 28 5818 完成 songjinzhou ref/pgupgrade.sgml
145 45811 40 19947 25 5909 完成 songjinzhou ref/pg_amcheck.sgml
146 79156 79 35078 52 23554 完成 songjinzhou ref/pg_basebackup.sgml
147 14155 14 6033 1 264 完成 songjinzhou ref/pg_checksums.sgml
148 48569 65 15583 1 838 完成 songjinzhou ref/pg_ctl-ref.sgml
149 118778 127 50071 91 37191 完成 wangkezhen ref/pg_dump.sgml
150 57214 64 22362 42 12852 完成 songjinzhou ref/pg_dumpall.sgml
151 38690 43 16190 7 3610 完成 songjinzhou ref/pg_receivewal.sgml
152 30845 36 11714 16 5087 完成 songjinzhou ref/pg_recvlogical.sgml
153 28590 39 10471 2 1348 完成 songjinzhou ref/pg_resetwal.sgml
154 74418 83 28880 58 17610 完成 songjinzhou ref/pg_restore.sgml
155 32591 39 13396 13 4558 完成 songjinzhou ref/pg_rewind.sgml
156 22557 36 5870 22 4452 完成 songjinzhou ref/pg_waldump.sgml
157 60972 82 24413 2 722 完成 songjinzhou ref/postgres-ref.sgml
158 20660 27 9084 1 215 完成 songjinzhou ref/prepare.sgml
159 410400 423 171027 258 106199 完成 songjinzhou ref/psql-ref.sgml
160 10634 20 3280 1 289 完成 songjinzhou ref/refresh_materialized_view.sgml
161 41520 47 18998 2 1394 完成 songjinzhou ref/reindex.sgml
162 8758 19 2263 1 191 完成 songjinzhou ref/release_savepoint.sgml
163 29871 25 13665 1 6025 完成 songjinzhou ref/revoke.sgml
164 10763 19 3468 1 377 完成 songjinzhou ref/rollback_to.sgml
165 11055 19 3577 2 926 完成 songjinzhou ref/savepoint.sgml
166 18749 22 6597 4 3343 完成 songjinzhou ref/security_label.sgml
167 203934 197 95529 45 27932 完成 songjinzhou ref/select.sgml
168 13870 19 4972 1 512 完成 songjinzhou ref/select_into.sgml
169 22802 26 9591 3 4771 完成 songjinzhou ref/set.sgml
170 12537 19 4828 1 454 完成 songjinzhou ref/set_role.sgml
171 10119 17 3630 1 471 完成 songjinzhou ref/set_session_auth.sgml
172 23322 26 10639 3 2959 完成 songjinzhou ref/set_transaction.sgml
173 12144 17 4521 1 749 完成 songjinzhou ref/show.sgml
174 38414 46 16312 2 1361 完成 songjinzhou ref/update.sgml
175 36389 42 15914 1 355 完成 songjinzhou ref/vacuum.sgml
176 43006 59 13912 39 7423 完成 songjinzhou ref/vacuumdb.sgml
177 18946 25 7189 1 1099 完成 林甲良 ref/values.sgml
178 69262 91 32030 2 2175 完成 林甲良 regress.sgml
179 820054 1101 206677 1099 206630 完成 ChenHuajun release-15.sgml
180 8928 9 4482 1 547 完成 林甲良 replication-origins.sgml
181 40825 39 20646 1 1015 完成 林甲良 rowtypes.sgml
182 178480 126 93091 5 9718 完成 林甲良 rules.sgml
183 237325 282 109099 14 15535 完成 林甲良 runtime.sgml
184 80328 109 35909 4 1304 完成 林甲良 sources.sgml
185 374803 681 110306 10 8149 完成 林甲良 spi.sgml
186 97122 130 44074 6 4706 完成 林甲良 storage.sgml
187 220400 260 101738 8 5173 完成 林甲良 syntax.sgml
188 383252 509 145855 147 43185 完成 林甲良 system-views.sgml
189 10000 12 4867 1 348 完成 林甲良 tableam.sgml
190 5623 6 2569 1 1135 完成 林甲良 test-decoding.sgml
191 316336 309 147913 22 27331 完成 林甲良 textsearch.sgml
192 82265 76 39612 29 9676 完成 林甲良 trigger.sgml
193 67817 89 29726 27 8520 完成 林甲良 user-manag.sgml
194 19331 24 7948 2 1809 完成 林甲良 uuid-ossp.sgml
195 83204 75 45257 3 1802 完成 林甲良 wal.sgml
196 52554 49 28451 1 1023 完成 林甲良 xaggr.sgml
197 265978 242 127426 18 14927 完成 林甲良 xfunc.sgml
198 36855 46 15174 1 870 完成 林甲良 xml2.sgml
199 21240120 24726 8859826 5324 1919429 合计
Add a custom footer
Add a custom sidebar
Clone this wiki locally