i18n - 3. 更新文档的流程

因为英文文档是基准，所以它必需被首先更新。这个更新可能来自于 i18n 团队（比如英文文档作者）或核心开发人员。

为了使得整个更新过程顺畅进行，应该遵循下面的流程。

3.1 通知进行翻译

当一份新文档发表，或英文文档发生修改以后，应该要有一个消息发到 fink-18n 邮件列表通知所有翻译者。这个通知包括下面的内容：

邮件主题中一个注解指明这是一个要求翻译的通知，例如：“[translation]”，或对于会推迟一些上线的英文文档是：“[translation-delayed]”。
除此以外，在消息中应该包含基准文档的文件名。
一个完整的 diff （例如：diff -Nru3 -rlast_revision rhead）来表明所做的修改。

附注：由于提交对 XML 文件的修改后会自动在 fink-commits 邮件列表中产生满足这个条件的邮件，所以一个方便的办法是修改这个邮件的主题然后把它重新发送作为通知。不过，当连续发生了很多更新的时候，可能就无法这样做了。

Note: When the new document is inside a new directory, you shoould add that new directory to the Makefile located in the xml directory. Otherwise the built process will not complete successfully.

3.2 新文档：

文档的英文版本会被提交并激活，然后按下面的办法进行翻译。

3.3 新翻译作品：

该语言团队的领导（或其它具有 CVS 访问权限的人）负责在翻译完成以后提交以及激活翻译的作品。

分类包括：

对文档的首次翻译。
对文档的部分翻译。
翻译一个新的英文文档

3.4 提示更新一个已经翻译的文档：

基准英文文档被提交并立即激活-修改者应该提交相应的 PHP 和 HTML 文件，并负责激活更新。翻译团队需要更新它们的版本，提交所有的文件（XML 和 PHP），然后激活更新。

Never change a dynamically generated php file; change the xml file instead.

Check that the cvsid line near the beginning of an xml file is not splitted.

注意：

对国际化指南（本文档），总是按这个模式处理，因为它的改变影响所有翻译团队。
对静态文档（那些不是由 XML 产生的 PHP 文件）也总是按照这个模式处理，因为它们很难延迟激活。

3.5 延迟更新现有文档（仅限由 XML 产生的文档）：

这种情况下，XML 文件的英文版本会被提交，但不会提交相应的 PHP 和 HTML 文件，也就是说，在 2.9节的关于动态文件部分的第 5 步完成后就结束。所有的翻译者在一个大家确定的时间段内进行翻译并仅仅提交相应的 XML 文件（也就是说，和英文版一样）。在这个时间段以后，由一个人，例如 i18n 核心团队的一员负责生成，提交和激活所有的 PHP 和 HTML 文件。

3.6 对开发者和英语文档作者

当前的政策是所有文档应该按照提示更新流程进行更新，除非你有很特别的理由不这样做。

Next: 4. 附加的资源