1
1
# PostgreSQL中文手册翻译计划
2
2
PostgreSQL官方手册对广大PostgreSQL用户来说是非常重要的学习和参考资料。
3
- 因此在2013年底PostgreSQL中国用户会成立了新的PG中文手册翻译小组,在第一代功勋laser所翻译的8 .2.3的基础上开启了9.3.1版本的手册翻译工作。
3
+ 因此在2013年底PostgreSQL中国用户会成立了由志愿者组成的新的PG中文手册翻译小组,在社区第一代功勋laser所翻译的8 .2.3的基础上开启了9.3.1版本的手册翻译工作。
4
4
翻译工作主要通过下面的翻译平台和QQ群进行管理,并且目前已完成了大部分的翻译工作。
5
5
但翻译中难免会有不准确的地方,希望读者发现问题后及时帮忙纠正,不断完善PG的中文手册。
6
6
@@ -15,7 +15,7 @@ QQ:309292849
15
15
https://github.com/postgres-cn/pgdoc-cn
16
16
17
17
本Github仓库存放已翻译好的sgml文件,通过这些sgml文件可编译成html和pdf等各种格式的文档。
18
- 本Github仓库接受对已翻译好的文档的质量改善,欢迎读者的反馈和修正(通过Issues和Pull requests),尚未翻译的十几个sgml文件的翻译工作目前仍在 “翻译平台”上管理。
18
+ 本Github仓库接受对已翻译好的文档的质量改善,欢迎读者的反馈和修正(通过Issues和Pull requests),尚未翻译的几个sgml文件的翻译工作目前仍在 “翻译平台”上管理。
19
19
20
20
21
21
## 文档的编译
@@ -70,7 +70,9 @@ cp -rf build/doc/src/sgml ../postgresql-9.3.1/doc/src/
70
70
71
71
6 . 编译PG手册
72
72
``` shell
73
- cd ../postgresql-9.3.1/doc/src/sgml
73
+ cd ../postgresql-9.3.1/
74
+ ./configure
75
+ cd doc/src/sgml
74
76
gmake html
75
77
```
76
78
参考:http://www.postgresql.org/docs/9.3/static/docguide-build.html
@@ -87,16 +89,15 @@ http://www.postgres.cn/docs/9.3
87
89
通过在线中文手册上每个页面右上角的“问题报告”和“纠错本页面”链接可直接跳转到Github仓库中的相应位置报告问题或在线修改。
88
90
89
91
90
-
91
- ## 离线文档
92
- 未稿
92
+ ## 离线手册
93
+ 计划等剩下的几个sgml翻译完成后,作成pdf等格式的离线手册
93
94
94
95
95
96
## 参与和协助翻译计划
96
97
### 1. 意见反馈
97
98
发现翻译文档中的问题后,进行反馈或对翻译工作提出建议
98
99
99
- 方式1. 在本Github仓库中发行Issue ,反映问题(请注明问题内容及所在的章节段落位置)或提出建议
100
+ 方式1. 在本Github仓库中 [ 发行Issue ] ( https://github.com/postgres-cn/pgdoc-cn/issues/new ) ,反映问题(请注明问题内容及所在的章节段落位置)或提出建议
100
101
101
102
方式2. 加入文档翻译QQ群(309292849),进行反馈
102
103
@@ -107,17 +108,17 @@ http://www.postgres.cn/docs/9.3
107
108
关于html页面和sgml文件的对应关系,可通过点击“在线阅读”web页面右上角的“纠错本页面”链接跳转到Github仓库中的相应sgml文件的编辑页面。
108
109
109
110
### 3. 文档翻译
110
- 目前仅剩余10几个sgml文件尚未翻译,其中还没有被认领的只有几个。当前这些剩余sgml的翻译工作仍在“翻译平台”上进行。
111
- 如果要对这些尚未翻译的文档进行翻译,请先注册并登录到“翻译平台”上申请“翻译”,翻译好的文档在“翻译平台”上提交。
111
+ 目前仅剩余的几个sgml文件的翻译工作仍在“翻译平台”上进行。
112
112
系统管理员会定期将“翻译平台”上的更新同步到Github仓库(但Github仓库上发生的更新不会反馈到“翻译平台”) 。
113
113
114
114
### 4. 文档校对
115
- 文档校对工作准备通过Github + wiki的方式进行,具体待定 。
115
+ 文档校对工作通过Github + wiki的方式进行,详见 [ PostgreSQL 9.3.1 中文手册的翻译校对 ] ( https://github.com/postgres-cn/pgdoc-cn/wiki/check9.3 ) 。
116
116
117
117
118
118
## 其它
119
119
1 . Github仓库中的sgml文件编码是UTF8(“翻译平台”上的是GBK)
120
- 2 . 系统管理员会定期将最新的Github仓库修正反映到在线中文手册,这一工作目前是手动做的,以后会自动化。
120
+ 2 . Github仓库中的修正会由后台程序每隔十分钟自动反映到在线中文手册中。
121
+ 3 . 如果Github仓库中的修正迟迟未能反映到在线中文手册,可能发生了编译错误,可通过查看[ 编译日志] ( http://postgres.cn/docs/9.3/build.log ) 了解情况。
121
122
122
123
123
124
0 commit comments