嗨,老铁,欢迎来到我的博客!

如果觉得我的内容还不错的话,可以关注下我在 segmentfault.com 上的直播。我主要从事 PHP 和 Java 方面的开发,《深入 PHP 内核》作者之一。

[视频直播] PHP 进阶之路 - 亿级 pv 网站架构的技术细节与套路 直播中我将毫无保留的分享我这六年的全部工作经验和踩坑的故事,以及会穿插着一些面试中的 考点难点加分点

周梦康 发表于 2014-03-29 6252 次浏览 标签 : PHP翻译

最近官方推出的完整介绍文档 大家可以参考下 https://wiki.php.net/doc/editor

第一阶段 在线编辑

使用facebook或者google帐号登录Php Docbook Online Editor https://edit.php.net别忘记了把语言模式选择为Chinese(Simplified)

Php Docbook Online Editor 做 PHP 官方文档翻译新手指引

登录可能会比较卡,进入控制面板之后,请先确认下选择的是中文文档的编辑界面

如果不是中文,请在控制面板修改下:

然后就搜索自己想要翻译的文档,由于正好之前我翻译的fsockopen因为edit.php.net的莫名BUG而丢失了,我就重新翻译一次,正好给大家截图演示下。

顺便提醒下大家,大家翻译完了最好是复制整个xml到自己本地保存一份,最近总是出现莫名其妙丢失的情况

先搜索,然后找到要编辑的文件(如果在Files need translate里面搜不到,就请到All files里面搜索),然后双击,就可以开始编辑了。

翻译的时候需要注意的问题:

1.别忘记了打标签

打开需要编辑的xml文件之后,如果第三行没有不是类似于下面的代码


<!-- EN-Revision: 331467 Maintainer: zhoumengkang Status: ready -->

则需要点击Recheck tag然后把第二行的版本号放到新添加的第三行中去。

补充说明Maintainer不能是中文,也不能包含空格,原因如下:http://mengkang.net/139.html

2.不需要翻译的内容

带&的蓝色内容不用翻译,函数表达式(方法简介标签<methodsynopsis>...</methodsynopsis>)不用翻译,函数标签(<function>...</function>)简单明了的不用翻译,如果需要翻译,请先翻译完加上一个括号,把原有的函数标签放到其中,因为解析完毕之后是超链接可以点击,最好不好删掉。超链接标签(<link>...</link>)中间的内容需要翻译。其他类似的情况不再枚举,大家注意点就行。

需要说明一点,比较遗憾的是在线编辑器没有可视化编辑的功能(没有像stackoverflow一样的编辑一点下面就是预览的功能)。

编辑完毕之后,然后提交给文档组管理员检查审核

进入Work in progress,点击你的名字下面的文档,然后右键,选择“Submit as patch for review in” ,“Create a new patch” 才能提交审核

然后你提交的patch就会显示在patches for review里面,后面的数目就是等待审核的数目,如果当前数目为0,表示都已经被审核了。

当文档管理人员将你的翻译审核通过,会有邮件提示的

如何查看自己翻译之后的效果呢?

比如我翻译的是fscokopen()的文档,那么就可以通过http://docs.php.net/manual/zh/function.fsockopen.php 查看(这是我接收到邮件提醒之后三小时后的截图)(docs.php.net 是PHP官方架设的文档测试服务区

注意,这里不是即时更新的。patch被接受后,几个小时之内更新到docs.php.net(该服务器每天更新四次,分别是 UTC 时间的 0:15、6:15、12:15 和 18:15)。每周五 UTC 10:46 更新主站的手册,随后会更新到各个镜像站点,比如 cn2.php.net。也就是说你提交的patch在被中文翻译这边的负责人review通过之后就能更新到文档测试服务器了。

第二阶段 使用SVN提交翻译文档

当你已经提交了不少的翻译文档之后,就可以申请svn账号了!获得svn账号之后,就可以自己提交代码,并且可以对其他新人的代码进行审核,并帮助他们提交了。

账号申请地址:http://php.net/git-php.php

在表单里面的For what purpose do you require a Git account:(check all that apply)里面的勾都去掉,在这一栏If your intended purpose is not in the list, please state it here:填写你的提交的补丁地址。

在这查看自己的补丁地址:http://news.php.net/php.doc.zh

查看到自己的记录例如我的这个http://news.php.net/php.doc.zh/4137

这是我的申请的截图,还不知道会不会审核通过。

帐号申请完毕后,申请的内容(填写的那个表单的内容)审核通过之后会出现在http://news.php.net/php.doc/官方文档组新闻列表之中。

例如这个就是我的申请记录:http://news.php.net/php.doc/969384920

出现在了邮件新闻列表中,不代表给你分发了SVN帐号,还需要等待官方对你的翻译文档的质量进行审查。由于官方的人员也是比较忙,所以不一定会看到你的申请,一周以后还没反应最好是给官方发邮件提醒下。联系邮箱是phpdoc@lists.php.net

官方审核通过后就会分发SVN帐号了,之后就可以使用SVN进行提交了,最近不知道为什么在线编辑器为什么总是出错,还是SVN稳定。

如何使用SVN提交翻译的文档请参考http://mengkang.net/105.html

第三阶段 对他人提交的代码做REVIEW

在php官方给你分发VCS(svn)帐号之后,不仅自己可以直接svn提交翻译的文档了,也有了对他人提交的代码进行review的权限。所以也就应该担当起review的责任。

具体如何操作请参考:(非常遗憾,现在在线编辑器有BUG,暂时只能使用下面的第二种方法)

使用在线编辑器来review http://mengkang.net/190.html

使用在线编辑器和svn来完成review http://mengkang.net/195.html

嗨,老铁,欢迎来到我的博客!

如果觉得我的内容还不错的话,可以关注下我在 segmentfault.com 上的直播。我主要从事 PHP 和 Java 方面的开发,《深入 PHP 内核》作者之一。

[视频直播] PHP 进阶之路 - 亿级 pv 网站架构的技术细节与套路 直播中我将毫无保留的分享我这六年的全部工作经验和踩坑的故事,以及会穿插着一些面试中的 考点难点加分点

评论列表

回复 daijie 2014-04-03 15:22:48
其实,Maintainer不能是中文,也不能包含空格,否则在线编辑器无法统计出这个帐号翻译的数量。
回复 周梦康 2014-04-03 16:04:25
回复1楼: 好的!我再修改下!
回复 2014-06-28 23:54:48
phpstorm上传到github出现这个错误,是哪里的问题呢