Skip to content
zuyue edited this page Nov 19, 2015 · 67 revisions

PostgreSQL9.4中文手册的翻译

PostgreSQL9.3中文手册目前处于校对阶段,以此同时,PostgreSQL9.4的翻译工作也开始展开。 本页面对PostgreSQL9.4中文手册翻译的步骤和注意事项进行说明。

9.4翻译项目管理上的约定

  1. 9.4的翻译文档(sgml)以git分支的形式存在,分支名为"9.4",而master分支对应的是9.3。
    https://github.com/postgres-cn/pgdoc-cn/tree/9.4
  2. 9.4的分支从master分支,也就是翻译好的9.3文档,拷贝过来。
  3. 9.4的翻译过程如下(由于是只翻译9.4和9.3的差异部分,所以过程更复杂)
    3.1 使用工具对比英文版9.3.1和英文版9.4.4中某个要翻译的sgml,看看做了哪些修改
    3.2 使用工具对比9.4分支(因为还没有翻译,所以内容就是中文版9.3.1)和英文版9.4.4的同名sgml,找到3.1中的各个差异点,并把9.4.4英文版中的修改内容合并到9.4分支。
    3.3 合并过程中遵照9.3翻译时的约定,即对需要翻译的部分,英文仍然以注释的形式拿过来,中文部分则需要调整或追加翻译。
    可以参考这个翻译好的alter_tablespace.sgml的例子:
    https://github.com/postgres-cn/pgdoc-cn/pull/31/files
    注)对比工具常用的有bcompare,WinMerge和Notepad++的compare插件等。
  4. 翻译中的9.4版手册可以通过以下URL查看,在9.4翻译完成之前,实际上大部分还是9.3的内容。
    http://postgres.cn/docs/9.4
  5. 由于校对9.3上的sgml可能会发生修改,这些修改由管理员不定期的合并到9.4中。
  6. 在9.3停止修改(校对完成)之前,9.3将一直作为master分支,9.4和以后的9.5等采用级联的方式fork前一个版本。即master(9.3)->9.4->9.5->...,这样,低版本上的翻译纠正可以很容易的merge到高版本上去。
  7. 有任何问题可以发行Issues,或到翻译QQ群:309292849进行讨论。

翻译步骤

1.登录github

如果还没有github账号,先注册一个,然后登录。

2.翻译预定

点击本页面右上角的Edit按按钮编辑下面的[作业分工及进度],在要预定的sgml文件的"翻译者"那一列填上自己的github的用户名。 同时把sgml文件的的状态从"待翻译"改成”翻译中“ 。 预定时优先预定9.4新增的和9.3已经校对完成的sgml,其次是"待校对"的sgml。

3.翻译sgml并提交

由于9.4的翻译工作面临很多不得不小心处理的问题,不推荐在Github上进行在线翻译,修改量很少可以立即完成的sgml文件可以例外。

  1. 通过git从原始库的9.4分支取sgml
  2. 修改sgml并保存
  3. 通过git将修改push到你的github仓库的9.4分支
  4. 从你的github仓库的9.4分支发pull request到原始库的9.4分支
    具体操作步骤可参考下面。
    http://blog.chinaunix.net/uid-20726500-id-5150100.html

4.状态更新

翻译完成后在[作业分工及进度]中的更新校对状态。把sgml文件的"9.4.4翻译状态"列中的状态从"翻译中"改成”完成“。

作业分工及进度

9.4状态:待翻译,翻译中,完成

NO	类型	A&M	DEL	9.3状态	9.4状态	翻译者	sgml	标题
1	修改	408	0	完成	完成	@韩悦悦	gin.sgml	57.GIN索引
2	修改	213	1	完成	翻译中	@ChenHuajun	protocol.sgml	48.前/后端协议
3	修改	181	71	完成	完成	@韩悦悦	ref/create_view.sgml	CREATE VIEW
4	修改	178	0	完成	完成	@韩悦悦	gist.sgml	55.1.介绍
5	修改	176	1	完成	翻译中	@ChenHuajun	syntax.sgml	4.SQL语法
6	修改	176	69	完成	完成	@韩悦悦	ref/select.sgml	SELECT
7	修改	168	1	完成	完成	@韩悦悦	mvcc.sgml	13.并发控制
8	修改	107	90	完成	完成	@韩悦悦	installation.sgml	15.源码安装
9	修改	106	0	完成	完成	@韩悦悦	bgworker.sgml	45.后台工作进程
10	修改	87	0	完成	完成	@韩悦悦	spgist.sgml	56.SP-GiST索引
11	修改	66	4	完成	完成	@韩悦悦	ref/alter_aggregate.sgml	ALTER AGGREGATE
12	修改	59	4	完成	完成	@韩悦悦	ref/drop_aggregate.sgml	DROP AGGREGATE
13	修改	50	4	完成	完成	@韩悦悦	ref/alter_foreign_table.sgml	ALTER FOREIGN TABLE
14	修改	46	4	完成	完成	@韩悦悦	ref/copy.sgml	COPY
15	修改	34	4	完成	完成	@韩悦悦	ref/create_tablespace.sgml	CREATE TABLESPACE
16	修改	33	1	完成	完成	@韩悦悦	storage.sgml	58.数据库物理存储
17	修改	25	11	完成	完成	@韩悦悦	ref/explain.sgml	EXPLAIN
18	修改	25	21	完成	完成	@韩悦悦	pageinspect.sgml	F.22.pageinspect
19	修改	20	0	完成	完成	@韩悦悦	install-windows.sgml	16.Windows下用源代码安装
20	修改	19	16	完成	完成	@韩悦悦	ref/comment.sgml	COMMENT
21	修改	17	4	完成	完成	@韩悦悦	ref/alter_index.sgml	ALTER INDEX
22	修改	16	16	完成	完成	@韩悦悦	ref/alter_extension.sgml	ALTER EXTENSION
23	修改	15	4	完成	完成	@韩悦悦	pg_xlogdump.sgml	pg_xlogdump
24	修改	13	12	完成	完成	@韩悦悦	ref/set_transaction.sgml	SET TRANSACTION
25	修改	12	0	完成	完成	@韩悦悦	sepgsql.sgml	F.33.sepgsql
26	修改	11	0	完成	完成	@韩悦悦	plhandler.sgml	51.书写一个过程语言处理器
27	修改	11	4	完成	完成	@韩悦悦	ref/grant.sgml	GRANT
28	修改	10	4	完成	完成	@韩悦悦	ref/create_database.sgml	CREATE DATABASE
29	修改	9	4	完成	完成	@韩悦悦	ref/vacuum.sgml	VACUUM
30	修改	8	4	完成	完成	@韩悦悦	ref/pg_resetxlog.sgml	pg_resetxlog
31	修改	8	4	完成	完成	@ChenHuajun	ref/alter_tablespace.sgml	ALTER TABLESPACE
32	修改	7	7	完成	完成	@ChenHuajun	ref/select_into.sgml	SELECT INTO
33	修改	6	4	完成	完成	@ChenHuajun	ref/abort.sgml	ABORT
34	修改	6	4	完成	完成	@ChenHuajun	ref/rollback.sgml	ROLLBACK
35	修改	5	0	完成	完成	@ChenHuajun	wal.sgml	29.可靠性和预写式日志
36	修改	4	0	完成	完成	@ChenHuajun	advanced.sgml	3.高级特性
37	修改	3	0	完成	完成	@ChenHuajun	indexam.sgml	54.索引访问方法接口定义
38	修改	2	0	完成	完成	@ChenHuajun	postgres.sgml	PostgreSQL 9.3.1 中文手册
39	修改	2	7	完成	完成	@ChenHuajun	nls.sgml	50.本地语言支持
40	修改	0	24	完成	完成	@ChenHuajun	geqo.sgml	53.基因查询优化器
41	修改	6279	0	待校对	待翻译	@待认领	release-9.3.sgml	E.1.版本 9.3.1
42	修改	3331	4	待校对	待翻译	@待认领	release-9.2.sgml	E.3.版本9.2.5
43	修改	2898	4	待校对	待翻译	@待认领	release-9.1.sgml	E.9.发布9.1.10
44	修改	2616	4	待校对	待翻译	@待认领	release-9.0.sgml	E.20.版本 9.0.14
45	修改	1617	97	待校对	待翻译	@待认领	func.sgml	9.函数和操作符
46	修改	1408	166	待校对	待翻译	@待认领	config.sgml	18.服务器配置
47	修改	1137	4	待校对	待翻译	@待认领	release-8.4.sgml	E.35.发布8.4.18
48	修改	405	131	待校对	待翻译	@待认领	catalogs.sgml	47.系统表
49	修改	381	0	待校对	待翻译	@待认领	xaggr.sgml	35.10.用户定义聚集
50	修改	322	4	待校对	待翻译	@待认领	ref/create_aggregate.sgml	CREATE AGGREGATE
51	修改	209	33	待校对	待翻译	@待认领	ref/psql-ref.sgml	psql
52	修改	207	27	待校对	待翻译	@待认领	plperl.sgml	42.PL/Perl - Perl 过程语言
53	修改	202	41	待校对	待翻译	@待认领	regress.sgml	30.回归测试
54	修改	174	56	待校对	待翻译	@待认领	queries.sgml	7.查询
55	修改	160	1	待校对	待翻译	@待认领	plpgsql.sgml	40.PL/pgSQL - SQL过程语言
56	修改	144	57	待校对	待翻译	@待认领	datatype.sgml	8.数据类型
57	修改	141	12	待校对	待翻译	@待认领	lobj.sgml	32.大对象
58	修改	138	190	待校对	待翻译	@待认领	client-auth.sgml	19.用户认证
59	修改	129	4	待校对	待翻译	@待认领	runtime.sgml	17.服务器设置和操作
60	修改	125	7	待校对	待翻译	@待认领	maintenance.sgml	23.日常数据库维护工作
61	修改	125	4	待校对	待翻译	@待认领	pgbench.sgml	pgbench
62	修改	123	4	待校对	待翻译	@待认领	monitoring.sgml	27.监控数据库的活动
63	修改	110	5	待校对	待翻译	@待认领	ref/alter_table.sgml	ALTER TABLE
64	修改	98	5	待校对	待翻译	@待认领	pgstatstatements.sgml	F.28.pg_stat_statements
65	修改	89	88	待校对	待翻译	@待认领	spi.sgml	44.服务器编程接口
66	修改	89	2	待校对	待翻译	@待认领	typeconv.sgml	10.类型转换
67	修改	88	4	待校对	待翻译	@待认领	ref/pg_basebackup.sgml	pg_basebackup
68	修改	82	10	待校对	待翻译	@待认领	libpq.sgml	31.libpq - C 库
69	修改	79	24	待校对	待翻译	@待认领	auto-explain.sgml	F.3.auto_explain
70	修改	74	0	待校对	待翻译	@待认领	pltcl.sgml	41.PL/Tcl - Tcl 过程语言
71	修改	69	4	待校对	完成	@韩悦悦	pgcrypto.sgml	F.25.pgcrypto
72	修改	62	0	待校对	完成	@韩悦悦	postgres-fdw.sgml	F.31.postgres_fdw
73	修改	61	4	待校对	完成	@韩悦悦	ref/create_table.sgml	CREATE TABLE
74	修改	46	32	待校对	完成	@韩悦悦	ref/pg_receivexlog.sgml	pg_receivexlog
75	修改	44	4	待校对	完成	@韩悦悦	pgstattuple.sgml	F.29.pgstattuple
76	修改	38	0	待校对	完成	@韩悦悦	extend.sgml	35.扩展SQL
77	修改	37	4	待校对	完成	@韩悦悦	ref/refresh_materialized_view.sgml	REFRESH MATERIALIZED VIEW
78	修改	37	14	待校对	完成	@韩悦悦	dfunc.sgml	编译和链接动态加载的函数
79	修改	36	2	待校对	完成	@韩悦悦	xfunc.sgml	35.3.用户定义的函数
80	修改	36	6	待校对	完成	@韩悦悦	rules.sgml	38.规则系统
81	修改	35	0	待校对	完成	@韩悦悦	release-8.0.sgml	E.126.版本 8.0.26
82	修改	34	0	待校对	完成	@韩悦悦	release-7.4.sgml	E.153.版本 7.4.30
83	修改	33	5	待校对	完成	@韩悦悦	uuid-ossp.sgml	F.41.uuid-ossp
84	修改	31	4	待校对	完成	@韩悦悦	ref/create_trigger.sgml	CREATE TRIGGER
85	修改	29	10	待校对	完成	@韩悦悦	ref/discard.sgml	DISCARD
86	修改	28	12	待校对	完成	@韩悦悦	ref/alter_view.sgml	ALTER VIEW
87	修改	27	27	待校对	完成	@韩悦悦	sslinfo.sgml	F.35.sslinfo
88	修改	27	1	待校对	完成	@韩悦悦	plpython.sgml	43.PL/Python - Python 过程语言
89	修改	27	0	待校对	完成	@韩悦悦	indices.sgml	11.索引
90	修改	27	0	待校对	完成	@韩悦悦	fdwhandler.sgml	52.写一个外数据包
91	修改	25	4	待校对	完成	@韩悦悦	ref/pg_restore.sgml	pg_restore
92	修改	25	0	待校对	完成	@韩悦悦	release-old.sgml	E.184.版本 7.3.21
93	修改	24	4	待校对	完成	@韩悦悦	ref/vacuumdb.sgml	vacuumdb
94	修改	22	0	待校对	完成	@韩悦悦	release-8.3.sgml	E.54.发布8.3.23
95	修改	21	0	待校对	完成	@韩悦悦	release-8.1.sgml	E.102.版本 8.1.23
96	修改	20	0	待校对	完成	@韩悦悦	datetime.sgml	B.日期/时间支持
97	修改	19	0	待校对	完成	@韩悦悦	manage-ag.sgml	21.管理数据库
98	修改	18	0	待校对	完成	@韩悦悦	file-fdw.sgml	F.14.file_fdw
99	修改	18	8	待校对	完成	@韩悦悦	docguide.sgml	J.文档
100	修改	18	16	待校对	完成	@韩悦悦	ref/security_label.sgml	SECURITY LABEL
101	修改	18	4	待校对	完成	@韩悦悦	ref/pg_dump.sgml	pg_dump
102	修改	17	0	待校对	完成	@韩悦悦	release-8.2.sgml	E.78.版本 8.2.23
103	修改	17	4	待校对	完成	@韩悦悦	ref/createuser.sgml	createuser
104	修改	16	5	待校对	完成	@韩悦悦	ref/set.sgml	SET
105	修改	16	4	待校对	完成	@韩悦悦	ref/initdb.sgml	initdb
106	修改	16	0	待校对	完成	@韩悦悦	sources.sgml	49.PostgreSQL 编码约定
107	修改	15	4	待校对	完成	@韩悦悦	ref/pg_dumpall.sgml	pg_dumpall
108	修改	14	0	待校对	完成	@韩悦悦	trigger.sgml	36.触发器
109	修改	14	4	待校对	完成	@韩悦悦	ref/create_function.sgml	CREATE FUNCTION
110	修改	13	0	待校对	完成	@韩悦悦	diskusage.sgml	28.监控磁盘使用情况
111	修改	12	0	待校对	完成	@韩悦悦	information_schema.sgml	34.信息模式
112	修改	12	0	待校对	完成	@韩悦悦	xindex.sgml	35.14.扩展索引接口
113	修改	11	0	待校对	完成	@韩悦悦	keywords.sgml	C.SQL关键字
114	修改	11	4	待校对	完成	@韩悦悦	ref/alter_foreign_data_wrapper.sgml	ALTER FOREIGN DATA WRAPPER
115	修改	11	14	待校对	完成	@韩悦悦	ecpg.sgml	33.ECPG - 在C中嵌入SQL
116	修改	10	5	待校对	完成	@韩悦悦	ref/postgres-ref.sgml	postgres
117	修改	8	4	待校对	完成	@韩悦悦	ref/create_foreign_data_wrapper.sgml	CREATE FOREIGN DATA WRAPPER
118	修改	8	4	待校对	完成	@韩悦悦	ref/create_rule.sgml	CREATE RULE
119	修改	7	0	待校对	完成	@韩悦悦	contrib.sgml	F.额外提供的模块
120	修改	7	4	待校对	完成	@韩悦悦	ref/pg_isready.sgml	pg_isready
121	修改	7	4	待校对	完成	@韩悦悦	ddl.sgml	5.数据定义
122	修改	6	17	待校对	完成	@韩悦悦	ref/reindex.sgml	REINDEX
123	修改	6	12	待校对	完成	@韩悦悦	ref/create_table_as.sgml	CREATE TABLE AS
124	修改	6	4	待校对	完成	@韩悦悦	ref/alter_materialized_view.sgml	ALTER MATERIALIZED VIEW
125	修改	6	4	待校对	完成	@韩悦悦	ref/pg_ctl-ref.sgml	pg_ctl
126	修改	6	6	待校对	完成	@韩悦悦	ref/set_constraints.sgml	SET CONSTRAINTS
127	修改	5	4	待校对	完成	@韩悦悦	ref/create_foreign_table.sgml	CREATE FOREIGN TABLE
128	修改	5	3	待校对	完成	@韩悦悦	reference.sgml	参考手册
129	修改	5	0	待校对	完成	@韩悦悦	citext.sgml	F.7.citext
130	修改	5	4	待校对	完成	@韩悦悦	ref/alter_tsdictionary.sgml	ALTER TEXT SEARCH DICTIONARY
131	修改	5	7	待校对	完成	@韩悦悦	ref/create_sequence.sgml	CREATE SEQUENCE
132	修改	5	4	待校对	完成	@韩悦悦	ref/create_index.sgml	CREATE INDEX
133	修改	4	15	待校对	完成	@韩悦悦	ref/create_cast.sgml	CREATE CAST
134	修改	4	19	待校对	完成	@韩悦悦	ref/pg_config-ref.sgml	pg_config
135	修改	3	0	待校对	完成	@韩悦悦	isn.sgml	F.19.isn
136	修改	3	0	待校对	完成	@韩悦悦	xml2.sgml	F.42.xml2
137	修改	3	3	待校对	完成	@韩悦悦	auth-delay.sgml	F.2.auth_delay
138	修改	3	3	待校对	完成	@韩悦悦	pgfreespacemap.sgml	F.26.pg_freespacemap
139	修改	2	3	待校对	完成	@韩悦悦	release.sgml	E.版本说明
140	修改	2	0	待校对	完成	@韩悦悦	event-trigger.sgml	37.事件触发器
141	修改	1	0	待校对	完成	@韩悦悦	passwordcheck.sgml	F.23.passwordcheck
142	修改	1	1	待校对	完成	@韩悦悦	pgrowlocks.sgml	F.27.pgrowlocks
143	修改	1	1	待校对	完成	@韩悦悦	xtypes.sgml	35.11.用户定义类型
144	修改	1	0	待校对	完成	@韩悦悦	hstore.sgml	F.16.hstore
145	修改	147	22	完成  	完成	@韩悦悦	recovery-config.sgml	26.恢复配置
146	修改	99	0	校对中	完成	@韩悦悦	high-availability.sgml	25.高可用性与负载均衡,复制
147	修改	51	9	校对中	完成	@韩悦悦	backup.sgml	24.备份与恢复
148	修改	38	1	完成  	完成	@韩悦悦	perform.sgml	14.性能提升技巧
149	修改	35	7	校对中	完成	@韩悦悦	pgupgrade.sgml	pg_upgrade
150	修改	24	13	校对中	完成	@韩悦悦	textsearch.sgml	12.全文检索
151	修改	13	0	校对中	完成	@韩悦悦	array.sgml	8.15.Arrays
152	新增	4990	0		完成	@韩悦悦	release-9.4.sgml	
153	新增	640	0		完成	@韩悦悦	logicaldecoding.sgml	
154	新增	540	0		完成	@韩悦悦	json.sgml	
155	新增	373	0		完成	@韩悦悦	ref/pg_recvlogical.sgml	
156	新增	142	0		完成	@韩悦悦	ref/alter_system.sgml	
157	新增	71	0		完成	@韩悦悦	test-shm-mq.sgml	
158	新增	68	0		完成	@韩悦悦	pgprewarm.sgml	
159	新增	42	0		完成	@韩悦悦	test-decoding.sgml	
160	修改	11	0		完成	@ChenHuajun	filelist.sgml	
161	修改	2	0		完成	@ChenHuajun	ref/allfiles.sgml	
162	修改	1	14		完成	@ChenHuajun	standalone-install.sgml	

Clone this wiki locally