PostgreSQL官方手册对广大PostgreSQL用户来说是非常重要的学习和参考资料。 因此在2013年底PostgreSQL**用户会成立了由志愿者组成的新的PG中文手册翻译小组，在社区第一代功勋laser所翻译的8.2.3的基础上开启了9.3.1版本的手册翻译工作。 翻译工作主要通过下面的翻译平台和QQ群进行管理，并且目前已完成了大部分的翻译工作。 但翻译中难免会有不准确的地方，希望读者发现问题后及时帮忙纠正，不断完善PG的中文手册。

http://58.58.27.50:8079/doc/doc/doc_center.php

QQ:309292849

关于翻译平台的使用方法，可参考翻译平台的帮助。

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

本Github仓库存放已翻译好的sgml文件，通过这些sgml文件可编译成html和pdf等各种格式的文档。 本Github仓库接受对已翻译好的文档的质量改善，欢迎读者的反馈和修正（通过Issues和Pull requests），尚未翻译的几个sgml文件的翻译工作目前仍在“翻译平台”上管理。

1 . 安装Perl

http://www.activestate.com/activeperl/downloads

2 . 下载本Github仓库

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

3 . 进入pgdoc-cn目录双击执行builddoc.bat

cd pgdoc-cn
builddoc.bat

4 . 查看编译效果

打开以下html文件查看编译效果

pgdoc-cn/build/doc/src/sgml/html/index.html

1 . 下载本Github仓库

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

2 . 下载对应版本的PostgreSQL源码并解压

wget https://ftp.postgresql.org/pub/source/v9.3.1/postgresql-9.3.1.tar.gz
tar xzf postgresql-9.3.1.tar.gz

3 . 对Github仓库中的sgml文件进行转码（UTF8->GBK）

cd pgdoc-cn
perl tools/encoding_convert.pl

4 . 用转码后的sgml文件覆盖PostgreSQL源码中的

cp -rf build/doc/src/sgml ../postgresql-9.3.1/doc/src/

5 . 下载编译PG手册所必需的工具集

参考：http://www.postgresql.org/docs/9.3/static/docguide-toolsets.html

6 . 编译PG手册

cd ../postgresql-9.3.1/
./configure
cd doc/src/sgml
gmake html

参考：http://www.postgresql.org/docs/9.3/static/docguide-build.html

7 . 查看编译效果 打开以下html查看编译效果

pgdoc-cn/build/doc/src/sgml/html/index.html

http://www.postgres.cn/docs/9.3

通过在线中文手册上每个页面右上角的“问题报告”和“纠错本页面”链接可直接跳转到Github仓库中的相应位置报告问题或在线修改。

计划等剩下的几个sgml翻译完成后，作成pdf等格式的离线手册

发现翻译文档中的问题后，进行反馈或对翻译工作提出建议

方式1. 在本Github仓库中发行Issue，反映问题（请注明问题内容及所在的章节段落位置）或提出建议

方式2. 加入文档翻译QQ群（309292849），进行反馈

发现翻译文档中的个别问题后，直接修正对应的sgml文件，并通过Pull Request向本Github仓库提交。 之后由系统管理员接受Pull Request。

关于html页面和sgml文件的对应关系，可通过点击“在线阅读”web页面右上角的“纠错本页面”链接跳转到Github仓库中的相应sgml文件的编辑页面。

目前仅剩余的几个sgml文件的翻译工作仍在“翻译平台”上进行。 系统管理员会定期将“翻译平台”上的更新同步到Github仓库（但Github仓库上发生的更新不会反馈到“翻译平台”） 。

文档校对工作通过Github + wiki的方式进行，详见PostgreSQL 9.3.1 中文手册的翻译校对（志愿者募集中）。
目前手册的大部分章节都没有经过校对，翻译上的小问题不少，欢迎有兴趣的童靴参加校对工作。

1. Github仓库中的sgml文件编码是UTF8（“翻译平台”上的是GBK）
2. Github仓库中的修正会由后台程序每隔十分钟自动反映到在线中文手册中。
3. 如果Github仓库中的修正迟迟未能反映到在线中文手册，可能发生了编译错误，可通过查看编译日志了解情况。