且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

PostgreSQL9.3中文手册的在线纠错

更新时间:2022-06-07 01:59:44

PostgreSQL9.3中文手册已经在PG中国社区的官网上正式发布了,下面是网址:
http://www.postgres.cn/docs/9.3

然而翻译中难免会有一些小错误。所以我们在在线手册的右上角做了个“纠错本页面”的链接,可以跳转到Github对应的文件编辑页面上进行在线纠错。

下面就用一个例子,演示一下“在线纠错”的操作步骤(如果你对github已经有一定了解了,可以跳过)

0. 注册github账号

首先你要注册一个github账号,可以进这个页面注册账号 https://github.com/join 。如果你已经有账号了,跳过这一步。

1. 发现错误

在浏览在线手册时,你无意间发现了一个小的翻译错误。
7.2 表表达式
PostgreSQL9.3中文手册的在线纠错

2. ”纠错本页面“

你准备亲自动手,把这个小Bug掐死在摇篮里。这时你可以点击正在浏览的在线手册页面右上角的”纠错本页面“。
PostgreSQL9.3中文手册的在线纠错


3. 用户登录

如果你还没有登录到github,那么会弹出登录页面。
PostgreSQL9.3中文手册的在线纠错

登录后,如果你之前没有fork过PG中文手册的Github仓库,gitbub会引导fork一个。
PostgreSQL9.3中文手册的在线纠错

4. 在线修改

现在已经进入到有问题的html页面所对应的sgml文件编辑页面上。找到刚才那个错误,把它改掉。
(注意每个中文翻译的上面都通过注释保留了英文原文,可以用来对照检查翻译的准确性。)
PostgreSQL9.3中文手册的在线纠错

修改完成后,写上有意义的提交消息,然后点击“Propose file change”
PostgreSQL9.3中文手册的在线纠错

5. 创建Pull request

刚才的修改是在你fork出来的自己的仓库上的,现在要把它推送到官方的仓库。
再此之前,应该查看一下下面的修改内容对比,再次确认一下修改的对不对。确认修改无误后,点击“Create Pull request”。
PostgreSQL9.3中文手册的在线纠错

需要的话,在推送请求里写点说明,再点击“Create Pull request”。这时Pull request就已经发出去了。
PostgreSQL9.3中文手册的在线纠错

6. 查看Pull request

进入这个URL,可以看到刚刚的推送的Pull request。看来你的修改请求真的被发出去了,后面就等管理员来合并你的请求了
https://github.com/postgre-cn/pgdoc-cn/pulls
PostgreSQL9.3中文手册的在线纠错