PHP手册翻译日记 [6] 若干结构改变
国庆长假将至,真是开心。这两天有点小空,翻译了手册中的一些内容,算是给PHPer们的一个小礼物。 本来想把所有PHP5.3的新内容给更新了,但发现手册有很大的改动,尤其是一些目录结构上的发动。必须先跟上这些改动,否则编译会出错,更谈不上进一步的翻译。
国庆长假将至,真是开心。这两天有点小空,翻译了手册中的一些内容,算是给PHPer们的一个小礼物。
本来想把所有PHP5.3的新内容给更新了,但发现手册有很大的改动,尤其是一些目录结构上的发动。必须先跟上这些改动,否则编译会出错,更谈不上进一步的翻译。
这两天主要做了以下工作:
1. 将翻译平台迁移到SVN
PHP官方的版本控制系统已经完全改成SVN。译者的SVN帐号与原来的CVS帐号相同,只需要激活一下即可。激活方式见readme.first,我已经更新到SVN里。
2. 控制结构
目录结构改变,原来的单个文件control-structures.xml被拆分成多个文件,放到"control-structures"目录。
翻译:
2) goto PHP5.3新增 3) 原来一些漏译的代码注释
1) 原来“for”这一部分的未翻译的内容。
/phpdoc/zh/trunk/language/control-structures.xml
/phpdoc/zh/trunk/language
/phpdoc/zh/trunk/language/control-structures
/phpdoc/zh/trunk/language/control-structures/alternative-syntax.xml
/phpdoc/zh/trunk/language/control-structures/break.xml
/phpdoc/zh/trunk/language/control-structures/continue.xml
/phpdoc/zh/trunk/language/control-structures/declare.xml
/phpdoc/zh/trunk/language/control-structures/do-while.xml
/phpdoc/zh/trunk/language/control-structures/else.xml
/phpdoc/zh/trunk/language/control-structures/elseif.xml
/phpdoc/zh/trunk/language/control-structures/for.xml
/phpdoc/zh/trunk/language/control-structures/foreach.xml
/phpdoc/zh/trunk/language/control-structures/goto.xml
/phpdoc/zh/trunk/language/control-structures/if.xml
/phpdoc/zh/trunk/language/control-structures/include-once.xml
/phpdoc/zh/trunk/language/control-structures/include.xml
/phpdoc/zh/trunk/language/control-structures/require-once.xml
/phpdoc/zh/trunk/language/control-structures/require.xml
/phpdoc/zh/trunk/language/control-structures/return.xml
/phpdoc/zh/trunk/language/control-structures/switch.xml
/phpdoc/zh/trunk/language/control-structures/while.xml
/phpdoc/zh/trunk/language/control-structures/goto.xml
3. PHP4面向对象部分
全部转移到appendices目录下。以后PHP中的“类与对象”默认就是指PHP5的,不再特地说明。
除了转移文件,还更新了所有的链接指向,并与EN手册的ID保持一致,如language.oop改为oop4或language.oop5(视具体情况)
P.S. 更新这些ID指向太让人吐血了,体力活,而且要很细心。
4. PHP5面向对象部分:
/phpdoc/zh/trunk/language/oop5.xml
/phpdoc/zh/trunk/language/oop5/inheritance.xml
/phpdoc/zh/trunk/language/oop5/late-static-bindings.xml
/phpdoc/zh/trunk/language/oop5/properties.xml
/phpdoc/zh/trunk/language/oop5/references.xml
/phpdoc/zh/trunk/language/oop5/typehinting.xml
后面4个文件未翻译,仅保持与英文版同步。
reflection部分移出。
翻译
__invoke方法文档 PHP5.3新增
匿名函数 PHP5.3新增
翻译手册本身不难,但真的是一个体力活。。每翻译一个文件,都要填写上该文件对应英文版手册的Revision。光是这个就让人烦得不行。
编译过程中出了很多错误,有将近100个ID引用问题,经过2天的努力,已经只剩下不到10个了。
争取在国庆之前编译中一个最新版的手册,包括在线版和CHM版本。