本页面对PostgreSQL 10.1中文手册翻译的步骤和注意事项进行说明。

1. 10.1的中文手册基于上一版的社区中文手册《PostgreSQL 9.6.0 中文手册》
2. 10.1相对于9.6.0新增的sgml为来自10.1的英文sgml；其余sgml均为9.6.0的中文sgml

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

https://ftp.postgresql.org/pub/source/v10.1/postgresql-10.1.tar.gz
https://ftp.postgresql.org/pub/source/v9.6.0/postgresql-9.6.0.tar.gz

在预定的sgml的翻译者栏填上自己的名字，并将翻译状态改为"翻译中"

1. 翻译sgml

2. 使用注释自动添加工具添加注释

   以acronyms.sgml文件为例，步骤如下

   cd pgdoc-cn
   python3 tools/pgdoc_add_commet.py postgresql/doc/src/sgml/acronyms.sgml ${原始10.1英文sgml解压目录}/postgresql-10.1/doc/src/sgml/acronyms.sgml ${临时sgml输出目录}/acronyms.sgml
   mv ${临时sgml输出目录}/acronyms.sgml postgresql/doc/src/sgml/acronyms.sgml

1. 对比10.1和9.6.0英文原始sgml找到变更点

2. 翻译变更内容并合并到github的sgml文件中

3. 使用注释自动添加工具删除之前的注释

   以acronyms.sgml文件为例，步骤如下

   cd pgdoc-cn
   python3 tools/pgdoc_del_commet.py postgresql/doc/src/sgml/acronyms.sgml ${临时sgml输出目录}/acronyms.sgml
   mv ${临时sgml输出目录}/acronyms.sgml postgresql/doc/src/sgml/acronyms.sgml

4. 使用注释自动添加工具重新添加注释

   以acronyms.sgml文件为例，步骤如下

   cd pgdoc-cn
   python3 tools/pgdoc_add_commet.py postgresql/doc/src/sgml/acronyms.sgml ${原始10.1英文sgml解压目录}/postgresql-10.1/doc/src/sgml/acronyms.sgml ${临时sgml输出目录}/acronyms.sgml
   mv ${临时sgml输出目录}/acronyms.sgml postgresql/doc/src/sgml/acronyms.sgml

注意:对不涉及注释变更的sgml，或已手动处理好注释的sgml，可以跳过3,4的注释处理。

github提交PR的步骤,可参考下面的例子。

• http://blog.chinaunix.net/uid-20726500-id-5150100.html

1. 编辑sgml文件时，请务必事先阅读翻译的注意点。
2. 为在提交PR前检查翻译效果需要构建文档编译环境，构建步骤参考Readme.md，但是目前windows上的编译有问题，需要在Linux上编译。
3. 在线翻译预览可以通过PostgreSQL 10.1 手册查看，PR被接受后，会被自动反映到在线文档中。

翻译状态:待翻译，翻译中，完成