PostgreSQL manual Chinese translation by China PostgreSQL Users Group http://www.postgres.cn/document
Github托管仓库
本Github仓库存放已翻译好的sgml文件,通过这些sgml文件可编译成html和pdf等各种格式的文档。 本Github仓库接受对已翻译好的文档的质量改善,欢迎读者的反馈和修正(通过Issues和Pull requests)。
翻译管理
分支管理
Master分支对于正在翻译的版本,当前是9.5.3;9.3分支对应于9.3.1;9.4分支对应于9.4.4。后面的说明均以9.3.1为例。
文档的编译
Windows上的编译
1 . 安装Perl
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
Linux/UNIX上的编译
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手册所必需的工具集
6 . 编译PG手册
cd postgresql-9.3.1
./configure
cd doc/src/sgml
gmake html
7 . 查看编译效果 打开以下html查看编译效果
postgresql-9.3.1/doc/src/sgml/html/index.html
在线中文手册
http://www.postgres.cn/docs/9.3
http://www.postgres.cn/docs/9.3.4
http://www.postgres.cn/docs/9.4
http://www.postgres.cn/docs/9.5
http://www.postgres.cn/docs/9.3.4
http://www.postgres.cn/docs/9.4
http://www.postgres.cn/docs/9.5
通过在线中文手册上每个页面右上角的“问题报告”和“纠错本页面”链接可直接跳转到Github仓库中的相应位置报告问题或在线修改。
离线中文手册
从Release页面,可以下载html和pdf格式的离线手册
参与和协助翻译计划
1. 意见反馈
发现翻译文档中的问题后,进行反馈或对翻译工作提出建议
方式1. 在本Github仓库中发行Issue,反映问题(请注明问题内容及所在的章节段落位置)或提出建议
方式2. 加入文档翻译QQ群(309292849),进行反馈
2. 错误纠正
发现翻译文档中的个别问题后,直接修正对应的sgml文件,并通过Pull Request向本Github仓库提交。 之后由系统管理员接受Pull Request。
关于html页面和sgml文件的对应关系,可通过点击“在线阅读”web页面右上角的“纠错本页面”链接跳转到Github仓库中的相应sgml文件的编辑页面。
其它
- Github仓库中的sgml文件编码是UTF8。
- Github仓库中的修正会由后台程序每隔十分钟自动反映到在线中文手册中。
- 如果Github仓库中的修正迟迟未能反映到在线中文手册,可能发生了编译错误,可通过查看编译日志了解情况.
from https://github.com/postgres-cn/pgdoc-cn