cvs: phpdoc-zh / readme.first translation.xml

From: Date: Sat, 13 Dec 2008 16:01:20 +0000
Subject: cvs: phpdoc-zh / readme.first translation.xml
Groups: php.doc.zh 
Request: Send a blank email to doc-zh+get-3064@lists.php.net to get a copy of this message
haohappy Sat Dec 13 16:01:20 2008 UTC Modified files: /phpdoc-zh readme.first translation.xml Log: File encoding changed from gb2312 to utf-8.

http://cvs.php.net/viewvc.cgi/phpdoc-zh/readme.first?r1=1.29&r2=1.30&diff_format=u Index: phpdoc-zh/readme.first diff -u phpdoc-zh/readme.first:1.29 phpdoc-zh/readme.first:1.30 --- phpdoc-zh/readme.first:1.29 Sat Dec 13 15:27:24 2008 +++ phpdoc-zh/readme.first Sat Dec 13 16:01:20 2008 @@ -1,183 +1,183 @@ -/* $Id: readme.first,v 1.29 2008/12/13 15:27:24 haohappy Exp $ */ +/* $Id: readme.first,v 1.30 2008/12/13 16:01:20 haohappy Exp $ */ ====================== - ÔÚ¼ÓÈë·­ÒëС×é֮ǰ + 在加入翻译小组之前 ====================== -¡¡¡¡PHP ÎĵµµÄ·­Ò빤×÷ÍêÈ«ÊÇÒ»ÏîÖ¾Ô¸Ðж¯£¬Äã²»»á´ÓÖеõ½ÈκÎÀûÒæ¡£¶øÇÒ -Òª½¨Á¢ÆðÒ»¸öÊʺϽøÐз­Ò빤×÷µÄ»·¾³Ò²ÊÇÏ൱·±ËöµÄ£¬ÀýÈçÉêÇë CVS Õ˺ţ¬ -ÓµÓÐ Unix/Linux »òÕß Cygwin µÄ»·¾³ÒÔ¼° CVS ¹¤¾ß£¬¶©ÔÄÏà¹ØµÄÓʼþÁÐ±í£¬ -·­ÒëÍê³Éºó»¹Òª¼ÌÐø¹Ø×¢Ó¢ÎÄÎĵµÊÇ·ñÓÐÁ˸üеȵȡ£ - -¡¡¡¡ÄãÄܵõ½µÄÊÇÊ²Ã´ÄØ£¿ÊÇÒ»ÖÖÎÞ˽·îÏײ¢ÓëÊÀ½ç¸÷µØµÄͬºÃÃÇÒ»Æð¹¤×÷µÄÀÖ -Ȥ£¬Ó¢ÎÄ·­ÒëˮƽµÄÌá¸ß£¨Ï£ÍûÕâÑù£©£¬¶Ô PHP ¸ü¼ÓÉîÈëµÄÁ˽âÒÔ¼°ÔÚ PHP ÎÄ -µµµÄÖÐÎÄÒ³ÃæÖÐÊðÉÏÄãµÄ´óÃû¡£ - -¡¡¡¡Èç¹ûÄã²»ÄÜÂú×ãÏÂÃæµÄËùÓÐÌõ¼þ£¬ÄÇôÄã¿ÉÄܲ»ÊʺϼÓÈë PHP ÎĵµµÄ·­Òë -¹¤×÷£º - -1. Ô¸Òâ½øÐÐÎÞ˽·îÏ×¼ÓÈëÕâ¸öÖ¾Ô¸Ðж¯£» -2. Ó¢Îij̶ȽϺã»ÓнϺõĺºÓïÊéÃæ±í´ïÄÜÁ¦¡£ -3. ¶Ô PHP ±¾ÉíÓÐÏ൱µÄÁ˽⣻ -4. ¶Ô Unix/Linux ÓÐÏ൱Á˽⣬Äܹ»×ÔÐн¨Á¢Æð CVS µÄ¹¤×÷»·¾³£» -5. ÔÚ²ÎÓë·­Ò빤×÷ʱ£¨Çë×¢ÒâÕâÒ»µã£©Ô¸ÒâΪ´ËͶÈë½Ï¶àʱ¼ä£¬²¢ÇÒÄܹ»Ñ¸ËÙ - Íê³É×Ô¼º³Ðµ£µÄÎļþµÄ·­Ò빤×÷¡£²»ÒªÒòΪһʱ³å¶¯¼ÓÈëÁË·­Ò빤×÷Ö®ºó£¬ - Ëù¾­ÊÖµÄÎļþÍê³ÉÒ»²¿·ÖÖ®ºóÈ´ÓÉÓÚÖÖÖÖÔ­Òò¶ø²»ÄܼÌÐøÏÂÈ¥¡£´ó¼Ò¶¼²»Ï£ - Íû¿´µ½Ò»¸öÎļþÀúʱÊý¸öÐÇÆÚÉõÖÁÊýÔ¶¼Î´ÄÜÍê³É·­Ò빤×÷£» -6. ÒÔºóÄܹ»¶¨ÆÚ·ÃÎʲ¢ÇÒ¾¡Á¿¸üÐÂ×Ô¼ºËùά»¤µÄÎļþ¡£ - -¡¡¡¡¼ÙÈçÄãÄܹ»×öµ½ÒÔÉÏÕ⼸µã£¬ÄÇô»¶Ó­Äã¼ÓÈë PHP ÖÐÎÄÎĵµ·­ÒëС×飡 - -¡¡¡¡ÊµÔÚÄÑÒÔ½¨Á¢ CVS ¹¤×÷»·¾³»òÕßÉêÇë²»µ½ CVS Õ˺ŵÄÅóÓÑÈç¹ûÔ¸Òâ²ÎÓ룬 -Ò²¿ÉÒÔ²ÉÓÃÕÛÖԵķ½·¨£¬¾ÍÊǽ«·­ÒëºÃµÄÎļþ·¢¸øÓÐ CVS Õ˺ŵijÉÔ±£¬ÈÃËûÃÇ -°ïÄãÌá½»¡£ +  PHP 文档的翻译工作完全是一项志愿行动,你不会从中得到任何利益。而且 +要建立起一个适合进行翻译工作的环境也是相当繁琐的,例如申请 CVS 账号, +拥有 Unix/Linux 或者 Cygwin 的环境以及 CVS 工具,订阅相关的邮件列表, +翻译完成后还要继续关注英文文档是否有了更新等等。 + +  你能得到的是什么呢?是一种无私奉献并与世界各地的同好们一起工作的乐 +趣,英文翻译水平的提高(希望这样),对 PHP 更加深入的了解以及在 PHP 文 +档的中文页面中署上你的大名。 + +  如果你不能满足下面的所有条件,那么你可能不适合加入 PHP 文档的翻译 +工作: + +1. 愿意进行无私奉献加入这个志愿行动; +2. 英文程度较好;有较好的汉语书面表达能力。 +3. 对 PHP 本身有相当的了解; +4. 对 Unix/Linux 有相当了解,能够自行建立起 CVS 的工作环境; +5. 在参与翻译工作时(请注意这一点)愿意为此投入较多时间,并且能够迅速 + 完成自己承担的文件的翻译工作。不要因为一时冲动加入了翻译工作之后, + 所经手的文件完成一部分之后却由于种种原因而不能继续下去。大家都不希 + 望看到一个文件历时数个星期甚至数月都未能完成翻译工作; +6. 以后能够定期访问并且尽量更新自己所维护的文件。 + +  假如你能够做到以上这几点,那么欢迎你加入 PHP 中文文档翻译小组! + +  实在难以建立 CVS 工作环境或者申请不到 CVS 账号的朋友如果愿意参与, +也可以采用折衷的方法,就是将翻译好的文件发给有 CVS 账号的成员,让他们 +帮你提交。 ======================== - ·­ÒëÖÐÐèҪעÒâµÄÎÊÌâ + 翻译中需要注意的问题 ======================== -1. ÎļþÊÇ UNIX µÄÎļþ¸ñʽ¶ø²»ÊÇ DOS µÄ£¬Ò²¾ÍÊÇÎļþÖеĻ»Ðбê¼ÇÖ»Óл» - Ðзû£¨\n£©£¬¶øÃ»Óлسµ·û£¨\r£©¡£²¢ÇÒÔÚÎļþÖв»ÒªÊ¹Óà <TAB>£¨ÖƱí·û - \t£©¶øÒªÊ¹Óÿոñ£» -2. Çë×¢Òâ·­ÒëÖеıêµãÎÊÌ⣬ʹÓÃÖÐÎıêµã·ûºÅ£» -3. ÖÐÓ¢ÎÄ×Ö´ÊÖ®¼äʹÓÿոñ·Ö¿ª£¬ÓëÖÐÎıêµãÖ®¼ä¾Í²»ÒªÓпոñÁË£» -4. ²»Òª·­Òë TRUE£¬FALSE£¬Boolean Ö®ÀàµÄ´Ê¡£·­ÒëÖÐÇë×¢Ò⣡ -5. Çë·­ÒëµÄʱºò×¢ÒâʹÓÃÊéÃæÓÃÓ·­ÒëÍê³Éºó¼ì²éÈ·ÈÏûÓдí±ð×ÖºÍÆäËü´í - ÎóºóÔÙÌá½»£¡ -6. Çë²Î¼Ó·­ÒëµÄÈËÔ±ÔÚ translation.xml ÖÐÌí¼Ó×Ô¼ºµÄ×ÊÁÏ£¬²¢ÔÚÈ·¶¨×Ô¼º - ·­Òëij¸öÎļþºóÁ¢¼´¸üÐÂ×Ô¼ºµÄ¹¤×÷½øÕ¹Çé¿ö£¬¶ø²»ÊÇÔÚ·­ÒëÍê³Éºó£¬ÒÔÃâ - ±ðÈ˵ÄÖØ¸´ÀͶ¯¡£ÕâÊDZØÐë×öµÄ¹¤×÷£¬·½±ã¿ØÖÆ·­Òë½ø¶È£» -7. ÇëÔÚ·­ÒëǰÈÏÕæÔĶÁ PHP Documentation HOWTO£¬ÓÈÆäÊǸÃÎĵµµÄµÚ 9 Õ - Information for Translators¡£Æä¼òÌåÖÐÎİæÒѾ­·­ÒëÍê³É£¬ÏÂÔØ·½Ê½ÔÚ - ±¾ÎÄ¡°ÈçºÎÔÚ Windows »·¾³ÏÂÀûÓà CVS Õ˺ŽøÐз­Ò빤×÷¡±Ò»½ÚÓÐ˵Ã÷¡£ -8. Çë²Î¼Ó·­ÒëµÄÈËÔ±¼ÓÈë doc-zh@lists.php.net ÓʼþÁбí.¾ßÌå·½·¨ÊÇÏò - doc-zh-subscribe@lists.php.net ·¢Ò»·â¿Õ°×µç×ÓÓʼþ£¬È»ºó»ØÐÅÈ·ÈÏ¡£ - ÎÒÃÇÔÚÕâÕâ¸öÓʼþÁбíÀïÃæÌÖÂÛºÍЭµ÷·­Ò빤×÷¡£¸ÃÓʼþÁбíµÄÄÚÈÝ¿ÉÒÔͨ - ¹ýÈçϵØÖ··ÃÎÊ http://news.php.net/group.php?group=php.doc.zh£» -9. Çë²Î¼Ó·­ÒëµÄÈËÔ±ÔÚÌá½»·­ÒëÍê³ÉµÄ XML ÎļþǰÔËÐÐ make test ÃüÁ¼ì - ²éÎļþÊÇ·ñÓÐÓï·¨ºÍƴд´íÎó¡£ - -========================== - ±êʶ×Ô¼ºµÄ ID ÒÔ¼°¹¤×÷ -========================== - -¡¡¡¡Çë²ÎÕÕ translation.xml ÖÐÒÑÓÐÈËÔ±µÄÑùʽÌí¼Ó×Ô¼ºµÄ ID¡£ÀýÈ磺 - -<person name="ÍõÔ¶Ö®" email="dallas@php.net" nick="dallas" cvs="yes" /> - -name : »áÏÔʾÔÚ±àÒëºóµÄÎĵµÖеÄÊ×Ò³ -email : ÓëÄãÁªÏµµÄµç×ÓÓʼþµØÖ·£¬ÇëÈ·±£Ê¹ÓôËÓʼþµØÖ·¿ÉÒÔÁªÂçµ½Ä㣬²»Ò» - ¶¨ÒªÊÇ @php.net µÄ¡£ -nick : ¸ø×Ô¼ºÆðµÄêdzơ£ÇëÈ·±£ÔÚÎĵµÍ·ÖÐµÄ Maintainer Óë´Ë±£³ÖÒ»Ö¡£ -cvs : ÊÇ·ñÓÐ cvs µÄÕ˺š£ +1. 文件是 UNIX 的文件格式而不是 DOS 的,也就是文件中的换行标记只有换 + 行符(\n),而没有回车符(\r)。并且在文件中不要使用 <TAB>(制表符 + \t)而要使用空格; +2. 请注意翻译中的标点问题,使用中文标点符号; +3. 中英文字词之间使用空格分开,与中文标点之间就不要有空格了; +4. 不要翻译 TRUE,FALSE,Boolean 之类的词。翻译中请注意! +5. 请翻译的时候注意使用书面用语,翻译完成后检查确认没有错别字和其它错 + 误后再提交! +6. 请参加翻译的人员在 translation.xml 中添加自己的资料,并在确定自己 + 翻译某个文件后立即更新自己的工作进展情况,而不是在翻译完成后,以免 + 别人的重复劳动。这是必须做的工作,方便控制翻译进度; +7. 请在翻译前认真阅读 PHP Documentation HOWTO,尤其是该文档的第 9 ç«  + Information for Translators。其简体中文版已经翻译完成,下载方式在 + 本文“如何在 Windows 环境下利用 CVS 账号进行翻译工作”一节有说明。 +8. 请参加翻译的人员加入 doc-zh@lists.php.net 邮件列表.具体方法是向 + doc-zh-subscribe@lists.php.net 发一封空白电子邮件,然后回信确认。 + 我们在这这个邮件列表里面讨论和协调翻译工作。该邮件列表的内容可以通 + 过如下地址访问 http://news.php.net/group.php?group=php.doc.zh; +9. 请参加翻译的人员在提交翻译完成的 XML 文件前运行 make test 命令,检 + 查文件是否有语法和拼写错误。 + +========================== + 标识自己的 ID 以及工作 +========================== + +  请参照 translation.xml 中已有人员的样式添加自己的 ID。例如: + +<person name="王远之" email="dallas@php.net" nick="dallas" cvs="yes" /> + +name : 会显示在编译后的文档中的首页 +email : 与你联系的电子邮件地址,请确保使用此邮件地址可以联络到你,不一 + 定要是 @php.net 的。 +nick : 给自己起的昵称。请确保在文档头中的 Maintainer 与此保持一致。 +cvs : 是否有 cvs 的账号。 -¡¡¡¡Îª±ãÓÚ¸ú×Ù·­Ò빤×÷ÒÔ¼°±£³ÖÓëÓ¢ÎÄÎĵµÒ»Ö£¬ÇëÓÃÒÔÏÂËÄÐдúÌæÔ­À´Ó¢ÎÄ -ÎĵµµÄǰÁ½ÐС£ +  为便于跟踪翻译工作以及保持与英文文档一致,请用以下四行代替原来英文 +文档的前两行。 <?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.29 $ --> +<!-- $Revision: 1.30 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.24 Maintainer: verdana Status: ready --> -ÓÐʱҲ¿ÉÒÔ¼ÓÈëÕâÑùÒ»ÐУº +有时也可以加入这样一行: <!-- CREDITS: Gregory,dallas --> -$Revision : ÖÐÎÄÎĵµµÄ°æ±¾ºÅ£¬×Ô¶¯¸üУ¬ÐÂÎļþ×ÜÊÇ´Ó 1.1 ¿ªÊ¼ -$Author : ×îºóÒ»´Î checkin µÄÈËÔ±µÄ cvs Õ˺ţ¬×Ô¶¯¸üР-EN-Revision : Ó뵱ǰÖÐÎÄÎĵµÏà¶ÔÓ¦µÄÓ¢ÎÄÎĵµµÄ°æ±¾ºÅ£¬·Ç³£ÖØÒª£¡ -Maintainer : ´ËÖÐÎÄÎĵµµÄά»¤Õߣ¬Ò»¶¨ÒªÓë translation.xml ÖÐµÄ nick - Ïàͬ£¬Çø·Ö´óСд£¡ -Status : ·­ÒëÍê³Éºóд ready£¬·­ÒëÒ»²¿·ÖµÄд partial -CREDITS : Èç¹ûÄã¶Ô±ðÈËά»¤µÄÎĵµ×öÁËÖØ´ó¸üлòÕßÍê³ÉÁËÆäÖÐÏ൱´óµÄ - Ò»²¿·Ö·­Ò빤×÷£¬ÇëÔÚÕâÀïÌíÉÏÄãµÄêdzƣ¬¶à¸öÈËÓöººÅ¸ô¿ª +$Revision : 中文文档的版本号,自动更新,新文件总是从 1.1 开始 +$Author : 最后一次 checkin 的人员的 cvs 账号,自动更新 +EN-Revision : 与当前中文文档相对应的英文文档的版本号,非常重要! +Maintainer : 此中文文档的维护者,一定要与 translation.xml 中的 nick + 相同,区分大小写! +Status : 翻译完成后写 ready,翻译一部分的写 partial +CREDITS : 如果你对别人维护的文档做了重大更新或者完成了其中相当大的 + 一部分翻译工作,请在这里添上你的昵称,多个人用逗号隔开 -×¢Ò⣨HaohppyÌí¼Ó£©£º +注意(Haohppy添加): <?xml version="1.0" encoding="gb2312"?> -´ËÐÐÒ²¿ÉÒÔ¸ÄΪ£º +此行也可以改为: <?xml version="1.0" encoding="utf-8"?> -È»ºó½«ÎļþÁí´æÎªutf-8¸ñʽ¡£ +然后将文件另存为utf-8格式。 -ÈçÔÚEditplusÖеã»÷¡°Îļþ¡±->¡°Áí´æÎª¡±->¡°±àÂ뷽ʽ¡±->"UTF-8" -»òÔÚVIMÖÐ +如在Editplus中点击“文件”->“另存为”->“编码方式”->"UTF-8" +或在VIM中 :set fileencoding=utf-8 :w -ʹÓÃUTF-8±£´æ¼æÈÝÐÔ¸üºÃ£¬²¢ÇÒͨ¹ýWeb·½Ê½·ÃÎʸüÐÂÁбíʱ¿ÉÒԺܺõÄÏÔʾÖÐÎĶø²»»á³öÏÖÂÒÂë¡£¹Ê¸ü½¨ÒéʹÓÃutf-8·½Ê½¡£ +使用UTF-8保存兼容性更好,并且通过Web方式访问更新列表时可以很好的显示中文而不会出现乱码。故更建议使用utf-8方式。 ========================== - ¶©ÔÄÓʼþÁбíµÄ¸½¼Ó˵Ã÷ + 订阅邮件列表的附加说明 ========================== -¡¡¡¡ºÜ¶àÈË¿ÉÄܳöÓÚ¸÷ÖÖ¿¼ÂDz»Ï£ÍûÓдóÁ¿Óʼþ½øÈë×Ô¼ºµÄÐÅÏä¡£½¨Òé´ó¼ÒʹÓà -Outlook Express ±¾Éí¾ßÓеÄÐÂÎÅ×鹦ÄÜ¡£·½·¨ÊÇÔÚ OE µÄ¹¤¾ß²Ëµ¥ÏÂÑ¡ÔñÕ˺Š-È»ºóÐÂÔöÒ»¸öÐÂÎÅ×éÕʺţ¬·þÎñÆ÷ÃûΪ news.php.net¡£È»ºóÔÚÆäÖж©ÔÄÏàÓ¦µÄ -ÐÂÎÅ×飬ÕâÑùËùÓеÄÐÂÎÅ×éÓʼþ¾Í¿ÉÒÔͨ¹ý OE À´ÔÚÏß¹Û¿´¶ø²»Óö©ÔÄÓʼþÁбí -ÁË£¬ÕâºÍ¶©ÔÄÓʼþÁÐ±í¹¦ÄÜÍêÈ«Ïàͬ¶øÇÒ¸ü¼ÓÖ±¹Û¡£ +  很多人可能出于各种考虑不希望有大量邮件进入自己的信箱。建议大家使用 +Outlook Express 本身具有的新闻组功能。方法是在 OE 的工具菜单下选择账号 +然后新增一个新闻组帐号,服务器名为 news.php.net。然后在其中订阅相应的 +新闻组,这样所有的新闻组邮件就可以通过 OE 来在线观看而不用订阅邮件列表 +了,这和订阅邮件列表功能完全相同而且更加直观。 -¡¡¡¡±ØÐë¶©ÔĵÄÐÂÎÅ×éÊÇ php.doc ºÍ php.doc.zh¡£Ç°Õß¿ÉÒÔ¿´µ½ËùÓÐÓ¢ÎİæÎÄ -¼þµÄ¸üжøºóÕßÊÇÖÐÎÄÎļþµÄ¸üÐÂÒÔ¼°ÖÐÎÄ·­ÒëС×é½»Á÷µÄµØ·½¡£ +  必须订阅的新闻组是 php.doc 和 php.doc.zh。前者可以看到所有英文版文 +件的更新而后者是中文文件的更新以及中文翻译小组交流的地方。 -¡¡¡¡ÒªÔÚij¸öÐÂÎÅ×é·¢ÑÔ£¬ÐèÒª½øÐÐÉí·ÝÈÏÖ¤£¬ÕâÊǸöÒ»´ÎÐԵŤ×÷¡£Ê×´ÎÏòij -¸öÐÂÎÅ×é·¢Ìû×Óºó»áÊÕµ½Ò»·âÓʼþ£¬Ö»Òª»Ø¸´¸ÃÓʼþ¾Í¿ÉÒÔͨ¹ýÈÏÖ¤£¬×Ô¼ºµÄ·¢ -ÑԲŻáÏÔʾÔÚÐÂÎÅ×éÖУ¬²¢ÇÒ·¢Ë͸øÏàÓ¦µÄÓʼþÁбí³ÉÔ±¡£ +  要在某个新闻组发言,需要进行身份认证,这是个一次性的工作。首次向某 +个新闻组发帖子后会收到一封邮件,只要回复该邮件就可以通过认证,自己的发 +言才会显示在新闻组中,并且发送给相应的邮件列表成员。 -¡¡¡¡Òª×¢ÒâµÄÊǻظ´ÈÏ֤ʱËùʹÓõÄ×Ô¼ºµÄÓʼþµØÖ·±ØÐë¾ÍÊÇÊ״η¢ÑÔʱËùʹÓà -µÄÓʼþµØÖ·¡£ +  要注意的是回复认证时所使用的自己的邮件地址必须就是首次发言时所使用 +的邮件地址。 - ÍÆ¼öʹÓÃgmailÓÊÏäÀ´¶©ÔÄÓʼþÁÐ±í£¬¿ÉÒÔͨ¹ý´´½¨filter½«ÓʼþÁбíÖÐµÄ - ÓʼþÌùÉϱêÇ©£¨tag£¬Èçphp-doc-zh£©²¢¹éµµ±£´æ£¬²»Ö±½ÓÏÔʾÔÚÊÕ¼þÏäÖУ¬ - ²»»áÓ°ÏìÆäËüÈÕ³£ÓʼþµÄä¯ÀÀ¡£ + 推荐使用gmail邮箱来订阅邮件列表,可以通过创建filter将邮件列表中的 + 邮件贴上标签(tag,如php-doc-zh)并归档保存,不直接显示在收件箱中, + 不会影响其它日常邮件的浏览。 ================================================== - ÈçºÎÔÚ Windows »·¾³ÏÂÀûÓà CVS Õ˺ŽøÐз­Ò빤×÷ + 如何在 Windows 环境下利用 CVS 账号进行翻译工作 ================================================== -¡¡¡¡´ËÎÊÌâÔÚ PHP Documentation HOWTO ¼°ÖÐÎİæÒëÎÄÖÐÓÐÏêϸÐðÊö£¬Çë²Î¿¼ -ÓйØÕ½ڡ£Çë·ÃÎÊÈçϵØÖ·£º +  此问题在 PHP Documentation HOWTO 及中文版译文中有详细叙述,请参考 +有关章节。请访问如下地址: http://cvs.php.net/co.php/phpdoc-zh/howto/howto_zh_cn.html.tar.gz -µã»÷ÓÒÉÏ½Ç Download Á´½Ó£¬ÏÂÔØ howto_zh_cn.html.tar.gz Îļþ¡£ +点击右上角 Download 链接,下载 howto_zh_cn.html.tar.gz 文件。 -×¢Ò⣺ -1. Çë²»ÒªÓà IE ÏÂÔØ´ËÎļþ£¬IE »á×ÔÐд¦Àí .gz Îļþ£¬½á¹û½âѹËõºóÖ»ÓÐ - Ò»¸öÎļþ£¬´ò¿ªºóÄÚÈݵßÈýµ¹ËÄ£¡ -2. ÔÚ Linux ÏÂÓÃÈçÏÂÃüÁî½âѹ¸ÃÎļþ£º +注意: +1. 请不要用 IE 下载此文件,IE 会自行处理 .gz 文件,结果解压缩后只有 + 一个文件,打开后内容颠三倒四! +2. 在 Linux 下用如下命令解压该文件: $tar zxvf howto_zh_cn.html.tar.gz ====================================== - ÈçºÎÔÚ CVS client ÖÐʹÓôúÀí·þÎñÆ÷ + 如何在 CVS client 中使用代理服务器 ====================================== -¡¡¡¡ÔÚ½ÌÓýÍøÖÐʹÓà CVS Ö±½ÓÁ¬½Ó cvs.php.net ·Ç³£Âý£¬Í¨³£»á³¬Ê±£¬Òò´ËÐè -ҪʹÓà Proxy¡£¶øÏÖÔÚ´ó²¿·Ö CVS Client ¶¼²»Ö§³Ö Proxy£¬Ö»ÓÐÒ»¸ö WinCVS -1.2 Ö§³Ö HTTP Proxy¡£µ«ÊÇ WinCVS µÄа汾ȴ²»ÔÙÖ§³Ö HTTP Proxy ÁË¡£ +  在教育网中使用 CVS 直接连接 cvs.php.net 非常慢,通常会超时,因此需 +要使用 Proxy。而现在大部分 CVS Client 都不支持 Proxy,只有一个 WinCVS +1.2 支持 HTTP Proxy。但是 WinCVS 的新版本却不再支持 HTTP Proxy 了。 -¡¡¡¡Èç¹ûÄãÔÚ½ÌÓýÍø¾Í¿ÉÒÔʹÓà WinCVS 1.2 ÅäºÏ Cygwin À´Ê¹Óᣰ²×°ºÃ -WinCVS 1.2 ÒԺ󣬽øÈëËüµÄ°²×°Ä¿Â¼£¬°Ñ cvs.exe ¿½±´³öÀ´¸²¸Ç -cygwin/bin/cvs.exe£¬»òÕß¿½±´µ½ CVSROOT¡£Õâ¸ö cvs.exe ÊÇÖ§³Ö HTTP Proxy -µÄ¡£ +  如果你在教育网就可以使用 WinCVS 1.2 配合 Cygwin 来使用。安装好 +WinCVS 1.2 以后,进入它的安装目录,把 cvs.exe 拷贝出来覆盖 +cygwin/bin/cvs.exe,或者拷贝到 CVSROOT。这个 cvs.exe 是支持 HTTP Proxy +的。 -¡¡¡¡ÉèÖà CVSROOT µÄʱºòÓе㲻ͬ£¬ÐèÒª¼ÓÈë´úÀí·þÎñÆ÷ÐÅÏ¢£¬ÀýÈ磺 +  设置 CVSROOT 的时候有点不同,需要加入代理服务器信息,例如: :pserver;proxy=192.168.0.1;proxyport=8080:verdana@cvs.php.net:/repository -×¢Òâ·ÖºÅºÍðºÅµÄÇø±ð¡£ +注意分号和冒号的区别。 -¡¡¡¡HTTP Porxy ±È½ÏºÃÕÒ£¬Èç¹ûÄãÓбȽϿìµÄ Socks 4/5 ´úÀí£¬¿ÉÒÔʹÓÃаæ -µÄ cvs.exe + sockscap32¡£ +  HTTP Porxy 比较好找,如果你有比较快的 Socks 4/5 代理,可以使用新版 +的 cvs.exe + sockscap32。 ============================================== - ÓйØÔÚ·­ÒëºóµÄÖÐÎÄÎļþÖеĿոñÓë»»ÐеÄ˵Ã÷ + 有关在翻译后的中文文件中的空格与换行的说明 ============================================== -¡¡¡¡ÔÚԭʼµÄÓ¢ÎÄ XML ÎļþÖв»´æÔÚ´ËÎÊÌ⣬ÒòΪӢÎĵ¥´ÊÖ®¼ä±¾À´¾ÍÓÐÒ»¸ö -¿Õ¸ñ£¬¶øÎÞÂÛÊÇ XML Îļþ»¹ÊDZàÒëºóµÄ HTML Îļþ¶Ô´ýÈκÎÁ¬ÐøµÄ¿Õ¸ñ£¬»Ø³µ -ÒÔ¼°ÖƱí·û¶¼µ±³ÉÒ»¸ö¿Õ¸ñ¿´´ý¡£µ«ÊÇÔÚÖÐÎÄÊéдϰ¹ßÖУ¬ºº×ÖÖ®¼äÒÔ¼°ÓëÖÐÎÄ -±êµã·ûºÅÖ®¼ä¶¼ÊÇûÓпոñµÄ¡£Òò´ËÓ¢ÎÄÎļþÖÐÀàËÆÕâÑùµÄ¶ÎÂ䣺 +  在原始的英文 XML 文件中不存在此问题,因为英文单词之间本来就有一个 +空格,而无论是 XML 文件还是编译后的 HTML 文件对待任何连续的空格,回车 +以及制表符都当成一个空格看待。但是在中文书写习惯中,汉字之间以及与中文 +标点符号之间都是没有空格的。因此英文文件中类似这样的段落: <para> This section applies to Windows 95/98/Me and @@ -186,132 +186,132 @@ we refer to the supported Windows platforms as Win32. </para> -ÔÚ±àÒëºóÏÔʾ³öÀ´µ±È»ÍêÈ«Õý³£¡£¿ÉÊÇÈç¹û·­Òë³ÉÕâÑù£º +在编译后显示出来当然完全正常。可是如果翻译成这样: <para> - ±¾½ÚÄÚÈÝÊÊÓÃÓÚ Windows 95/98/Me ÒÔ¼° Windows NT/2000/XP¡£ - PHP ²»ÄÜÔÚ16λƽ̨ÀýÈç Windows 3.1 ÏÂÔËÐС£ÓÐʱÎÒÃÇ°Ñ - Ö§³Ö PHP µÄ Windows ƽ̨³ÆÎª Win32¡£ + 本节内容适用于 Windows 95/98/Me 以及 Windows NT/2000/XP。 + PHP 不能在16位平台例如 Windows 3.1 下运行。有时我们把 + 支持 PHP 的 Windows 平台称为 Win32。 </para> -¾Í»áÔÚ HTML Ò³ÃæÏÔʾʱÔÚ¡°XP¡£¡±ºÍ¡°PHP ²»ÄÜ¡±ÒÔ¼°¡°ÎÒÃǰѡ±ºÍ¡°Ö§³Ö¡± -Ö®¼ä³öÏÖÒ»¸ö²»Ï£ÍûµÄ¿Õ¸ñ£¬ÆÆ»µÁËÒ³ÃæµÄÃÀ¹Û¡£ÕâÖÖÇé¿öϵ±È»¿ÉÒÔ½«·­ÒëµÄ -½á¹ûÈ«²¿·Åµ½Í¬Ò»ÐÐÖÐÀ´½â¾ö£¬ÀýÈ磺 +就会在 HTML 页面显示时在“XP。”和“PHP 不能”以及“我们把”和“支持” +之间出现一个不希望的空格,破坏了页面的美观。这种情况下当然可以将翻译的 +结果全部放到同一行中来解决,例如: <para> - ±¾½ÚÄÚÈÝÊÊÓÃÓÚ Windows 95/98/Me ÒÔ¼° Windows NT/2000/XP¡£PHP ²»ÄÜÔÚ16λƽ̨ÀýÈç Windows 3.1 ÏÂÔËÐС£ÓÐʱÎÒÃǰÑÖ§³Ö PHP µÄ Windows ƽ̨³ÆÎª Win32¡£ + 本节内容适用于 Windows 95/98/Me 以及 Windows NT/2000/XP。PHP 不能在16位平台例如 Windows 3.1 下运行。有时我们把支持 PHP 的 Windows 平台称为 Win32。 </para> -µ«ÕâÑù¸ø·­ÒëʱµÄÔĶÁÓÖ´øÀ´Á˲»±ã¡£¿ÉÓõĽâ¾ö·½·¨ÊÇÔÚ·­ÒëºóµÄÎļþÖб£Áô -ÏÂÀ´µÄÓ¢Îĵ¥´Êǰºó»»ÐÐ £­ ¼ÈÈ»ÖÐÓ¢ÎÄ×Ö´ÊÖ®¼ä±¾À´¾ÍÊÇÓÿոñ¸ô¿ªµÄ²¢ÇÒÒ» -¸ö¿Õ¸ñºÍ¶à¸ö¿Õ¸ñÒ²Ã»Ê²Ã´Çø±ð¡£ÄÇôÒÔÉÏÕâÒ»¶ÎÔÚÖÐÎÄÎļþÖпÉÒÔд³ÉÕâÑù£º -£¨Òª×¢Ò⣬²»ÒªÔÚÖÐÎıêµã·ûºÅǰºó»»ÐУ¡£© +但这样给翻译时的阅读又带来了不便。可用的解决方法是在翻译后的文件中保留 +下来的英文单词前后换行 - 既然中英文字词之间本来就是用空格隔开的并且一 +个空格和多个空格也没什么区别。那么以上这一段在中文文件中可以写成这样: +(要注意,不要在中文标点符号前后换行!) <para> - ±¾½ÚÄÚÈÝÊÊÓÃÓÚ Windows 95/98/Me ÒÔ¼° - Windows NT/2000/XP¡£PHP ²»ÄÜÔÚ16λƽ̨ÀýÈç - Windows 3.1 ÏÂÔËÐС£ÓÐʱÎÒÃǰÑÖ§³Ö - PHP µÄ Windows ƽ̨³ÆÎª Win32¡£ + 本节内容适用于 Windows 95/98/Me 以及 + Windows NT/2000/XP。PHP 不能在16位平台例如 + Windows 3.1 下运行。有时我们把支持 + PHP 的 Windows 平台称为 Win32。 </para> -ÕâÑùÒ»À´ÏÔʾµÄʱºò¾ÍûÎÊÌâÁË¡£Èç¹û·­Òëºó½á¹ûÊÇÒ»´ó¶Î´¿ÖÐÎĵÄÎı¾£¬ÄÇ¾Í -û°ì·¨ÁË£¬Ö»ÄÜÀÏÀÏʵʵ·ÅÔÚͬһÐУ¬¼´Ê¹ºÜ³¤ºÜ³¤¡£ +这样一来显示的时候就没问题了。如果翻译后结果是一大段纯中文的文本,那就 +没办法了,只能老老实实放在同一行,即使很长很长。 -¡¡¡¡×ÜÖ®Ô­ÔòÊÇÔÚ±£Ö¤ÏÔʾ³öÀ´µÄÒ³ÃæÃÀ¹ÛÎÞÎóµÄÇé¿öϼæ¹Ëԭʼ XML ÎļþµÄ -¿É¶ÁÐÔ¡£ +  总之原则是在保证显示出来的页面美观无误的情况下兼顾原始 XML 文件的 +可读性。 ========================== - ÎҵŤ×÷»·¾³ £­ Dallas + 我的工作环境 - Dallas ========================== -¡¡¡¡±¾È˵Ť×÷»·¾³ÈçÏ£º +  本人的工作环境如下: -²Ù×÷ϵͳ£ºWindows XP Professional English Version -CVS »·¾³£ºÓà VMWare Workstation °²×°µÄ FreeBSD 5.0-RELEASE -±à¼­Æ÷ £ºUltraEdit 9.10b +操作系统:Windows XP Professional English Version +CVS 环境:用 VMWare Workstation 安装的 FreeBSD 5.0-RELEASE +编辑器 :UltraEdit 9.10b -Óà VMWare °²×°µÄ FreeBSD ¿ÉÒÔ±£Ö¤ÓµÓÐÒ»¸öԭ֭ԭζµÄ UNIX ϵͳ£¬Õâ±ÈÓà -Cygwin ÒªºÃµÃ¶à¡£¿ÉÒÔͬʱʹÓà Linux ºÍ Windows ¸÷×ÔµÄÌØÉ«ºÍÓŵ㡣ֻҪ -Óà samba ½« phpdoc Ŀ¼¹²Ïí³öÀ´¾Í¿ÉÒÔÓà UltraEdit Ö±½Ó¶ÔÔ´Îļþ½øÐвÙ×÷ -ÁË¡£ +用 VMWare 安装的 FreeBSD 可以保证拥有一个原汁原味的 UNIX 系统,这比用 +Cygwin 要好得多。可以同时使用 Linux 和 Windows 各自的特色和优点。只要 +用 samba 将 phpdoc 目录共享出来就可以用 UltraEdit 直接对源文件进行操作 +了。 -¡¡¡¡UltraEdit ¿ÉÒÔÕýȷʶ±ð²¢×ª»» Unix ºÍ DOS µÄÎļþ¸ñʽ£¬±ÜÃâ³ö´í£¬²¢ -ÇÒ±¾Éí¾Í¾ßÓÐÁË XML ÎļþµÄÓï·¨¸ßÁÁÏÔʾ¡£»¹¿ÉÒÔ¶¨ÒåһЩºê£¬½«¾­³£³öÏÖµÄ -×Ö´Ê×Ô¶¯Ìæ»»£¬Ê¡µôһЩÊÖ¹¤ÀͶ¯¡£ +  UltraEdit 可以正确识别并转换 Unix 和 DOS 的文件格式,避免出错,并 +且本身就具有了 XML 文件的语法高亮显示。还可以定义一些宏,将经常出现的 +字词自动替换,省掉一些手工劳动。 -¡¡¡¡VMWare Workstation µ±Ç°°æ±¾ÊÇ 4.0.0£¬·Ç³£·½±ãÒ×Ó㬲»µ½ 20M µÄ´óС£¬ -¿ÉÒÔÓÃËü°²×°¸÷¸ö°æ±¾µÄ Linux »òÕß FreeBSD¡£ÓÉÓÚ½øÐÐ PHP Îĵµ·­Ò빤×÷Ö» -ÐèÒªÎı¾Ä£Ê½£¬Òò´Ë°²×°ºóµÄ´óС¿ÉÒÔÔÚ 500M ÒÔÏ£¬¶øÇÒËùÐèÒªµÄÄÚ´æ¿ÉÒÔÉè -¶¨ÔÚ 32M ¾Í×ã¹»ÁË£¬²¢²»ÏûºÄºÜ¶àϵͳ×ÊÔ´¡£Virtual PC µÄ°®ºÃÕßµ±È»Ò²¿ÉÒÔ -Ñ¡Ôñ Virtual PC¡£ +  VMWare Workstation 当前版本是 4.0.0,非常方便易用,不到 20M 的大小, +可以用它安装各个版本的 Linux 或者 FreeBSD。由于进行 PHP 文档翻译工作只 +需要文本模式,因此安装后的大小可以在 500M 以下,而且所需要的内存可以设 +定在 32M 就足够了,并不消耗很多系统资源。Virtual PC 的爱好者当然也可以 +选择 Virtual PC。 ========================== - ÎҵŤ×÷»·¾³ £­ Gregory + 我的工作环境 - Gregory ========================== - ±¾È˵Ť×÷»·¾³ÈçÏ£º + 本人的工作环境如下: - ²Ù×÷ϵͳ£ºWindows 2000 Server / Professional ¼òÌåÖÐÎİæ - CVS »·¾³£ºCygwin + WinCVS 1.3.8.1 - ±à¼­Æ÷£ºEditplus 2.11c + 操作系统:Windows 2000 Server / Professional 简体中文版 + CVS 环境:Cygwin + WinCVS 1.3.8.1 + 编辑器:Editplus 2.11c - ÓÉÓÚ±¾ÈË¶Ô Linux ϵͳ²»ºÜ¾«Í¨£¬Òò´ËĿǰ¶ÔÓÚÎÒÀ´Ëµ£¬½¨Á¢ÕâÑùÒ»¸ö»·¾³Î¨Ò» -µÄÄ¿µÄ¾ÍÊǽøÐÐ phpdoc µÄ·­Ò빤×÷£¬Òò´ËʹÓà Cygwin ÊÇÒ»¸ö±È½Ï¼ò±ãºÍ¾­¼ÃµÄ·½Ê½¡£ -¶øÇÒ£¬Cygwin ÍêÈ«¿ÉÒÔÍê³É phpdoc ÏîÄ¿Éæ¼°µÄ¾ø´ó²¿·Ö£¨ÕâÀï˵¡°¾ø´ó²¿·Ö¡±ÊÇΪÁË -²»Ê§¿Í¹ÛÐÔ£¬ÊÂʵÉϵ½Ä¿Ç°ÎªÖ¹£¬ÎÒ»¹Ã»ÓÐÔÚ¸ÃϵͳÏÂÓöµ½ÈκÎÎÞ·¨Âú×ãµÄ¹¦ÄÜ£©²Ù×÷¡£ -¼ÓÉÏ WinCVS ¿ÉÊÓ»¯µÄ CVS ²Ù×÷½çÃæ£¬ÎÞÒɸøÏ°¹ßʹÓà Windows ϵͳµÄÎÒ´øÀ´ÁË·½±ã¡£ + 由于本人对 Linux 系统不很精通,因此目前对于我来说,建立这样一个环境唯一 +的目的就是进行 phpdoc 的翻译工作,因此使用 Cygwin 是一个比较简便和经济的方式。 +而且,Cygwin 完全可以完成 phpdoc 项目涉及的绝大部分(这里说“绝大部分”是为了 +不失客观性,事实上到目前为止,我还没有在该系统下遇到任何无法满足的功能)操作。 +加上 WinCVS 可视化的 CVS 操作界面,无疑给习惯使用 Windows 系统的我带来了方便。 - ÔÚÄú½¨Á¢ºÃÁË CVS µÄ±¾µØ repository ºó£¬WinCVS Äܹ»Ê¶±ð×ÊÔ´¿âϲ»Í¬µÄÎļþ£¬ -°Ñ²»Í¬Àà±ðµÄÎļþÓò»Í¬µÄͼ±ê±íʾ£¬Ê¹Äú¶ÔÅÓ´óµÄĿ¼½á¹¹Ò»Ä¿ÁËÈ»¡£¶øÇÒ£¬Ëü»¹»á°Ñ -¸ü¸Ä¹ýµÄÎļþ×ųɺìÉ«£¬ÔÚ commit Ö®ºó»á°ÑÑÕÉ«ÔٸĻØÀ´¡£¶øÇÒËüÖ§³ÖÍâ¹ÒÎı¾±à¼­Æ÷£¬ -ÅäºÏºóÎÄÌáµ½µÄ Editplus ʹÓ㬶ÔÓÚϰ¹ß Windows µÄÓû§À´Ëµ£¬ÊµÔÚÊÇ·½±ã¡£ + 在您建立好了 CVS 的本地 repository 后,WinCVS 能够识别资源库下不同的文件, +把不同类别的文件用不同的图标表示,使您对庞大的目录结构一目了然。而且,它还会把 +更改过的文件着成红色,在 commit 之后会把颜色再改回来。而且它支持外挂文本编辑器, +配合后文提到的 Editplus 使用,对于习惯 Windows 的用户来说,实在是方便。 - µ±È»£¬¸Ã»·¾³µÄÍÆ¼öÊǽöÕë¶ÔÄÇЩ¶Ô Linux/Unix ϵͳ²»ÊÇÊ®·ÖÊìϤ£¬²¢¸üÇãÏòÓÚ -ÔÚ Windows »·¾³Ï½øÐз­Ò빤×÷µÄ¶ÁÕߵġ£Èç¹ûÄúÊÇ Linux/Unix ¸ßÊÖ»òÕßÊÇ M$ µÄ -·´¶ÔÕߣ¬ÎÒÍêÈ«ÓÐÀíÓÉÏàÐÅÒÔÉÏ Dallas µÄϵͳ»á¸üÊʺÏÄú¡£ + 当然,该环境的推荐是仅针对那些对 Linux/Unix 系统不是十分熟悉,并更倾向于 +在 Windows 环境下进行翻译工作的读者的。如果您是 Linux/Unix 高手或者是 M$ 的 +反对者,我完全有理由相信以上 Dallas 的系统会更适合您。 - Editplus ÊÇÒ»¿îÀàËÆÓÚ UltraEdit µÄ´¿Îıʱ༭Æ÷£¬»òÐíÓÉÓÚ Editplus ½Ï -UltraEdit ³öÏÖµÄÍí£¬ÀÏÒ»±²µÄ´óϺÃǸüÇãÏòÓÚʹÓúóÕߣ»µ«±¾È˾­¹ý³¤ÆÚʹÓà Editplus -½øÐÐ HTML/XML/SQL/PHP µÄ¿ª·¢£¬ÈÏΪËüÕæµÄÊÇÒ»¿î·Ç³£ÖµµÃÍÆ¼öµÄ±à¼­Æ÷¡£ + Editplus 是一款类似于 UltraEdit 的纯文笔编辑器,或许由于 Editplus 较 +UltraEdit 出现的晚,老一辈的大虾们更倾向于使用后者;但本人经过长期使用 Editplus +进行 HTML/XML/SQL/PHP 的开发,认为它真的是一款非常值得推荐的编辑器。 - Ê×ÏÈ Editplus ¾ßÓÐÓï·¨¸ßÁÁ£¬×Ô¶¯Íê³ÉµÈÏÖ´úÎı¾±à¼­Æ÷µÄ»ù±¾¹¦ÄÜ£¬¸üÖØÒªµÄ -ÊÇ£¬Ëü³ýÁË×Ô´øÒ»Ð©Á÷ÐÐÓïÑÔ£¨ÈçC/C++¡¢JAVA¡¢VBScript¡¢JavaScript¡¢HTML¡¢XML¡¢ -PHP¡¢Perl¡¢JSP¡¢CSS£©µÄÓï·¨¸ßÁÁºÍ×Ô¶¯Íê³ÉÒÔÍ⣬»¹ÓÐHTML¡¢ASP 3.0¡¢CSS 2¡¢ -PHP 4 µÈ³£ÓÃÓïÑÔµÄÔªËØ¿â£¬ÒÔ¼° ANSI ºÍ ¿ØÖÆ×Ö·ûµÄË÷Òý£»Äú»¹¿ÉÒÔ×Ô¼º¶¨ÒåÐ嵀 -Óï·¨¸ßÁÁºÍ×Ô¶¯Íê³Éµµ£¬ÒÔ¼°×Ô¼º³£ÓÃµÄ Cliptext¡£ - ÁíÍ⣬Editplus ¾ßÓкÜÇ¿µÄ¿ª·¢»·¾³Ñùʽ¶¨Ò壬´ÓÕÛÐз½Ê½µ½TAB×Ö·ûµ½Ã¿¼¶Ëõ½ø -µÄ×Ö·ûÊýµ½Óï·¨¸ßÁÁµÄ¾ßÌåÑÕÉ«£¬Ê¹¿ª·¢´°¿Ú×î´ó³Ì¶ÈÉÏ·ûºÏÄúµÄϰ¹ß£»Í¬Ê±£¬¿É½«±£´æ -µÄ·½Ê½ÔÚ PC/UNIX/MAC Ö®¼äÇл»£¬Âú×㲻ͬµÄÐèÒª¡£ + 首先 Editplus 具有语法高亮,自动完成等现代文本编辑器的基本功能,更重要的 +是,它除了自带一些流行语言(如C/C++、JAVA、VBScript、JavaScript、HTML、XML、 +PHP、Perl、JSP、CSS)的语法高亮和自动完成以外,还有HTML、ASP 3.0、CSS 2、 +PHP 4 等常用语言的元素库,以及 ANSI 和 控制字符的索引;您还可以自己定义新的 +语法高亮和自动完成档,以及自己常用的 Cliptext。 + 另外,Editplus 具有很强的开发环境样式定义,从折行方式到TAB字符到每级缩进 +的字符数到语法高亮的具体颜色,使开发窗口最大程度上符合您的习惯;同时,可将保存 +的方式在 PC/UNIX/MAC 之间切换,满足不同的需要。 ========================== - ÎҵŤ×÷»·¾³ £­ Jiania + 我的工作环境 - Jiania ========================== -×îбàÒë»·¾³,Windows+PHP+Phd+notepad++»òÊÇÆäËüXMLÈí¼þ +最新编译环境,Windows+PHP+Phd+notepad++或是其它XML软件 - ÏÖÔÚ·­ÒëphpÎĵµ,²»ÐèÒªÏñÉÏÃæËù˵µÄÄÇÑùÂé·³Á÷³Ì,Ö»ÐèÔÚ±¾µØÓÐphp»·¾³¾ÍÐÐÁË - ½¨Òé php5.3»·¾³ÏÂʹÓÃ!Ïà¹ØPHP°²×°ÂÔ + 现在翻译php文档,不需要像上面所说的那样麻烦流程,只需在本地有php环境就行了 + 建议 php5.3环境下使用!相关PHP安装略 - PhD ÅäÖÆ + PhD 配制 - 1.ÐèÒªÀ©Õ¹ + 1.需要扩展 1.1. libxml2 1.2. xmlreader 1.2. dom - °²×°·½·¨Á½ÖÖ - 1.ʹÓà PEAR Channel + 安装方法两种 + 1.使用 PEAR Channel pear channel-discover doc.php.net pear install doc.php.net/phd-beta pear upgrade doc.php.net/phd-beta - »òÊÇÖ±½ÓURL°²×° + 或是直接URL安装 pear install http://doc.php.net/phd/PhD-0.2.3.tgz - ×¢:×îа´µÚÒ»ÖÖ·½·¨°²×°,¿ÉÒÔ»ñµÃ×îа汾 + 注:最新按第一种方法安装,可以获得最新版本 - 2.ʹÓÃCVS + 2.使用CVS 2.1 cvs -d:pserver:cvsread@cvs.php.net/repository co phd cd phd @@ -319,7 +319,7 @@ cd phd php build.php -d /path/to/phpdoc/.manual.xml - 2.2 ±àÒëphpdoc + 2.2 编译phpdoc cvs -d:pserver:cvsread@cvs.php.net/repository co phpdoc-zh cd phpdoc-zh php configure.php @@ -327,23 +327,23 @@ ========================== - ÎҵŤ×÷»·¾³ £­ Haohappy + 我的工作环境 - Haohappy ========================== -·­Òë»·¾³£º -²Ù×÷ϵͳ£ºWindows XP Professional -CVS »·¾³£ºTortoiseCVS ¶ÔÓ¦ (CVSNT) 2.5.03 -±à¼­Æ÷ £ºEditPlus +翻译环境: +操作系统:Windows XP Professional +CVS 环境:TortoiseCVS 对应 (CVSNT) 2.5.03 +编辑器 :EditPlus -±àÒë»·¾³£º -²Ù×÷ϵͳ£ºLinux Fedora release 7 (Moonshine) -±à¼­Æ÷ £ºVIM +编译环境: +操作系统:Linux Fedora release 7 (Moonshine) +编辑器 :VIM -°Ñ·­ÒëºÍ±àÒë»·¾³·Ö¿ªÊÇΪÁËÔÚLinuxÏÂÓÃcrontableʵÏÖ¶¨ÆÚ±àÒëÊֲᣬµ«ÓÐʱÎÒ -Ò²»áÖ±½ÓÔÚLinuxÐ޸ĺÍÌá½»Îļþ¡£ÕâÁ½¸öƽ̨¶¼·Ç³£·½±ã£¬°´×Ô¼ºÏ°¹ßÑ¡Ôñ¼´¿É¡£ +把翻译和编译环境分开是为了在Linux下用crontable实现定期编译手册,但有时我 +也会直接在Linux修改和提交文件。这两个平台都非常方便,按自己习惯选择即可。 -ÔÚWindowsƽ̨ÏÂÇ¿ÁÒÍÆ¼öʹÓÃTortoiseCVS×÷ΪCVS×÷Ϊ¿Í»§¶Ë£¬²Ù×÷·Ç³£·½±ã¡£ +在Windows平台下强烈推荐使用TortoiseCVS作为CVS作为客户端,操作非常方便。 -ÎҵıàÒë¹ý³ÌºÍJiania»ù±¾Ïàͬ£¬²¹³äÁ½µã£º -1. ÓÐʱºò¿ÉÄÜÒòΪÊÖ²áÕ½ÚÖÐijЩxmlÎļþÄÚÈݸñʽ²»¶Ô£¬ÎÞ·¨Éú³É.manual.xml£¬¿ÉÒÔʹÓòÎÊý"--enable-force-dom-save"Ç¿ÖÆÉú³É¡£ -2. Èç¹ûÏë²é¿´ÏêϸµÄ³ö´íÔ­Òò£¬¿ÉÒÔ¼ÓÉϲÎÊý"--enable-xml-details" \ No newline at end of file +我的编译过程和Jiania基本相同,补充两点: +1. 有时候可能因为手册章节中某些xml文件内容格式不对,无法生成.manual.xml,可以使用参数"--enable-force-dom-save"强制生成。 +2. 如果想查看详细的出错原因,可以加上参数"--enable-xml-details" \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-zh/translation.xml?r1=1.145&r2=1.146&diff_format=u Index: phpdoc-zh/translation.xml diff -u phpdoc-zh/translation.xml:1.145 phpdoc-zh/translation.xml:1.146 --- phpdoc-zh/translation.xml:1.145 Sat Dec 13 15:01:17 2008 +++ phpdoc-zh/translation.xml Sat Dec 13 16:01:20 2008 @@ -1,11 +1,11 @@ -<?xml version="1.0" encoding="gb2312" ?> +<?xml version="1.0" encoding="utf-8" ?> <!DOCTYPE translation SYSTEM "../dtds/translation.dtd"> -<!-- $Id: translation.xml,v 1.145 2008/12/13 15:01:17 haohappy Exp $ --> +<!-- $Id: translation.xml,v 1.146 2008/12/13 16:01:20 haohappy Exp $ --> <translation xmlns="http://docbook.org/ns/docbook"> <intro> - PHP Îĵµ¼òÌåÖÐÎÄ·­Ò빤×÷ÓɼòÌåÖÐÎÄ·­ÒëС×鸺Ô𣬳ÉÔ±¼ûÏÂ±í¡£<br /> - ÓйØÎÊÌâ¼°·­Ò빤×÷Çé¿öÇë·ÃÎÊ <a href="http://news.php.net/group.php?group=php.doc.zh">php.doc.zh ÌÖÂÛ×é</a>¡£ + PHP 文档简体中文翻译工作由简体中文翻译小组负责,成员见下表。<br /> + 有关问题及翻译工作情况请访问 <a href="http://news.php.net/group.php?group=php.doc.zh">php.doc.zh 讨论组</a>。 </intro> <chmindex> @@ -13,39 +13,39 @@ </chmindex> <translators> - <person name="ÍõÔ¶Ö®" email="dallas@php.net" nick="dallas" cvs="yes" /> - <person name="ФÀí´ï" email="nio@php.net" nick="nio" cvs="yes" /> - <person name="ФʢÎÄ" email="yincheng@php.net" nick="yincheng" cvs="yes" /> - <person name="ºé½¨¼Ò" email="jiania@php.net" nick="Jiania" cvs="yes" /> - <person name="»ÆÐ¥Óî" email="class007@php.net" nick="class007" cvs="yes" /> - <person name="ËÎç÷" email="gregory@php.net" nick="Gregory" cvs="yes" /> - <person name="³Â²®ÀÖ" email="bole.Chen@gmail.com" nick="Avenger" cvs="yes" /> - <person name="³ÂºÆ" email="haohappy@php.net" nick="haohappy" cvs="yes" /> - <person name="ÁõÃú" email="lm92@php.net" nick="lm92" cvs="yes" /> - <person name="´ÞÑÒ" email="cysoft@php.net" nick="cysoft" cvs="yes" /> - <person name="ÄÂÉÙÀÚ" email="verdana@php.net" nick="verdana" cvs="yes" /> - <person name="Àî´ï" email="thomaslio@php.net" nick="thomaslio" cvs="yes" /> - <person name="ÖÜð©" email="zhouhao007@php.net" nick="micky" cvs="yes" /> - <person name="ËïÂG" email="yorgo@php.net" nick="yorgo" cvs="yes" /> - <person name="ÈÝØ¹" email="phpvcn@gmail.com" nick="esayr" cvs="yes" /> + <person name="王远之" email="dallas@php.net" nick="dallas" cvs="yes" /> + <person name="肖理达" email="nio@php.net" nick="nio" cvs="yes" /> + <person name="肖盛文" email="yincheng@php.net" nick="yincheng" cvs="yes" /> + <person name="洪建家" email="jiania@php.net" nick="Jiania" cvs="yes" /> + <person name="黄啸宇" email="class007@php.net" nick="class007" cvs="yes" /> + <person name="宋琪" email="gregory@php.net" nick="Gregory" cvs="yes" /> + <person name="陈伯乐" email="bole.Chen@gmail.com" nick="Avenger" cvs="yes" /> + <person name="陈浩" email="haohappy@php.net" nick="haohappy" cvs="yes" /> + <person name="刘铭" email="lm92@php.net" nick="lm92" cvs="yes" /> + <person name="崔岩" email="cysoft@php.net" nick="cysoft" cvs="yes" /> + <person name="穆少磊" email="verdana@php.net" nick="verdana" cvs="yes" /> + <person name="李达" email="thomaslio@php.net" nick="thomaslio" cvs="yes" /> + <person name="周皓" email="zhouhao007@php.net" nick="micky" cvs="yes" /> + <person name="孙翯" email="yorgo@php.net" nick="yorgo" cvs="yes" /> + <person name="容毓" email="phpvcn@gmail.com" nick="esayr" cvs="yes" /> </translators> <work-in-progress> <!-- -±¾ÎļþÄÚÈݽöÓÃÓÚ revcheck ÖУ¬Îª¸ü¼ÓÃ÷È·£¬Ôݰ´ÕÕÒÔÏ·½Ê½Ìîд£º +本文件内容仅用于 revcheck 中,为更加明确,暂按照以下方式填写: -<file name="Ŀǰ¹¤×÷ÄÚÈÝ" person="êdzÆ" type="Ŀǰ¹¤×÷״̬" - date="¿ªÊ¼ÈÕÆÚ" revision="Ŀǰ¹¤×÷·¶Î§" /> +<file name="目前工作内容" person="昵称" type="目前工作状态" + date="开始日期" revision="目前工作范围" /> --> - <file name="¸üйýÆÚÎļþ" person="dallas" type="¸üÐÂÖÐ" date="2005-08-08" revision="ËùÓйýÆÚÎļþ" /> - <file name="language/oop5/*" person="lm92" type="¸üÐÂÖÐ" date="2007-05-10" /> - <file name="¸üйýÆÚÎļþ" person="yincheng" type="ÔÝÍ£" date="2005-07-05" /> - <file name="·­Ò벿·ÖÐÂÎļþ" person="class007" type="ÔÝÍ£" date="2005-04-17" /> - <file name="¸üйýÆÚÎļþ" person="Avenger" type="¸üÐÂÖÐ" date="2006-04-19" /> - <file name="·­ÒëÐÂÕ½ڼ°ÏûÃð±àÒë´íÎó" person="haohappy" type="¸üÐÂÖÐ" date="2008-12-13" /> + <file name="更新过期文件" person="dallas" type="更新中" date="2005-08-08" revision="所有过期文件" /> + <file name="language/oop5/*" person="lm92" type="更新中" date="2007-05-10" /> + <file name="更新过期文件" person="yincheng" type="暂停" date="2005-07-05" /> + <file name="翻译部分新文件" person="class007" type="暂停" date="2005-04-17" /> + <file name="更新过期文件" person="Avenger" type="更新中" date="2006-04-19" /> + <file name="翻译新章节及消灭编译错误" person="haohappy" type="更新中" date="2008-12-13" /> </work-in-progress>
« previous php.doc.zh (#3064) next »