PEAR 手册
向前Chapter 6. FAQ - Frequently Asked Questions下一个

有一种工具能帮助PEAR手册的翻译者跟踪文件的变化吗?

翻译工作可不单单是翻译提交.更多的工作是更新已经翻译的文件.动态的取得英文文件,跟随英文结构,你需要订阅PEAR文档. mailing list 得到CVS的提交信息,或者阅读档案.如果你不能更新你的文件,翻译就没有意义了.

翻译会比较困难,比如你不知道何时何人翻译过这个文件, 你也不能知道那里能找到升级需要的东西. 我们有修正和修改数据文件的 pear文档记录..

The Revision Comments

修正的注释系统存储了文件规定的信息. 翻译的信息,修正的数量,状况信息都被存储在版本注释中. 让我们看下例子中头部的东西吧. bookinfo.xml 文件: 
<!-- EN-Revision: 1.16 Maintainer: jane Status: ready -->

我们看到了翻译文件的版本号(EN-Revision: 1.16),翻译文件的CVS汇总名称. 但是我们能添加一些其它需要的信息(等等 "部分"不完全的翻译).这些修订提交系统存贮了主要的XML文件信息,并没有在核心位置. 这样极其方便,毕竟里面有1300多个英文的文件.

通常,在三个方面(英文修正版,维护者,状态)是必要的.维护者是CVS用户的约定名称. 或者昵称. 状态是不能有空格的任何信息. 注意,这些头部不能被CVS更新(差异 $Revision, 自动被更新).当你修改的注释内容被更新时候.

你能看到这些好处 有了用这些注释,你不能快速看到所有的文件了. 不会的影响你.而且会更方便,如果你想看到所有的文件,进入 /peardoc/ directory,运行 
./scripts/revcheck_pear.php xx > revcheck.html
这里 xx是假设的语言文档 执行后你会看到 revcheck.html在同样的目录下. 不同的语言.链接一样的.添加更多的参数也一样

一些html中有些可选代码扩展介绍, 这就是为什么 translation.xml 文件是介绍.. 例子: translation.xml 文件是虚构的XX语言 : 
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE translation SYSTEM "../dtds/translation.dtd">

<translation>

 <intro>
  This is some introductory text for the xx language translators
  about who is the manager of the translation, and where to find
  more information. This paragraph is printed on the top of the
  generated revcheck.html page.
 </intro>
 
 <translators>
  <person name="Joe Doe"     email="joe@hotmail.com"  nick="joedoe" cvs="yes" editor="yes"/>
  <person name="Jane Smith"  email="jsmith@yahoo.com" nick="jane"   cvs="yes"/>
  <person name="Joe Forever" email="joe@forever.net"  nick="joefo"  cvs="no"/>
 </translators>
 
 <work-in-progress>
  <file name="appendices/aliases.xml" person="joedoe" type="working"/>
  <file name="functions/dbx.xml"      person="joefo"  type="working"/>
 </work-in-progress>

</translation>
这个文件中.你可以不用CVS而加入 用户,分配文件给他们. 添加所有信息的好处是动态翻译表格. revcheck.html 文件. 所有的翻译者从指派的个人文件被连接在一起.

这里有两个可选的参数你可以加到一个文件中,如果你想记录它. : 日期 修改. 日期是工作开始的时间.版本是英文版本的版本号. 信任给所有的参与者. history.xml 能看到(能看到Joe Doe 翻译了开始的一些文件,但是 Jane跟随翻译了后面的. ): 
<!-- CREDITS: joedoe -->
翻译者通常把这些提示者加入到 revcheck.html.

向前首页下一个
Why does the PEAR coding standard insist on space-only indentation?向上Developer Guide

Back

Forward

Copy

PEAR Packages

Developer Mailing Lists

General Mailing List

CVS Commits Mailing List

PHP Manual

Google

AllTheWeb

Print

Refresh