Code Monkey home page Code Monkey logo

pgdoc-cn's Introduction

PostgreSQL中文手册翻译计划

PostgreSQL官方手册是PostgreSQL非常重要的学习和参考资料。为促进PostgreSQL在国内的普及,2013年12月PostgreSQL**用户会成立了由志愿者组成的新的PG中文手册翻译小组,在社区第一代功勋laser所翻译的8.2.3中文手册的基础上开启了9.3.1版本的手册翻译工作并于2015年7月翻译完成。之后又于2016年4月完成了9.4.4的翻译,绝大部分翻译工作由翰高的韩悦悦和另一名同事完成。9.5及以后的翻译工作基于武汉大学的彭煜玮教授独自翻译的PostgreSQL 9.4.4中文手册和社区之前翻译的《PostgreSQL9.4.4中文手册》。

文档翻译QQ群

QQ:309292849

文档翻译QQ群用于文档翻译相关的交流。

Github托管仓库

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

本Github仓库存放已翻译好的sgml文件,通过这些sgml文件可编译成html和pdf等各种格式的文档。 本Github仓库接受对已翻译好的文档的质量改善,欢迎读者的反馈和修正(通过Issues和Pull requests)。

翻译管理

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

分支管理

Master分支对于正在翻译的版本,当前是9.5.3;9.3分支对应于9.3.1;9.4分支对应于9.4.4。后面的说明均以9.3.1为例。

文档的编译

Windows上的编译

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

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手册所必需的工具集

参考: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查看编译效果

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

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

离线中文手册

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

从Release页面,可以下载html和pdf格式的离线手册

参与和协助翻译计划

1. 意见反馈

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

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

方式2. 加入文档翻译QQ群(309292849),进行反馈

2. 错误纠正

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

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

其它

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

pgdoc-cn's People

Contributors

chenhuajun avatar zuyue avatar highgodb-yinminmin avatar lyhabc avatar ldming avatar xiaowing avatar liuyuanyuan avatar cuik avatar hayleeliu avatar baoyuanzh avatar jackandlarvage avatar mofelee avatar zjin1126 avatar collinske avatar iammajia avatar dongyaosen avatar

Watchers

James Cloos avatar diankuizhao avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.