如何使用WinCVS来下载和获得FreeBSD简体中文计划的文档源文件，并提交patch

$Phantasm: delphijweb/research/cnproj-cvs/index.htm,v 1.1 2006/05/21 17:11:17 delphij Exp $

引言

本文档针对没有任何CVS操作经验，但希望能够融入FreeBSD简体中文计划进展的人士而撰写。此文档会不定期更新，但作者不保证其内容时刻处于有效状态。关于FreeBSD简体中文计划的最新信息，请参阅这篇文档，这份文档最终会合并到其中。

入门

现状

目前，FreeBSD简体中文计划采用并行版本控制系统(CVS)来作为日常的文档维护同步手段[1]。为了与官方的CVS配合，我们使用CVSup(R)来将官方的修改合并到我们的CVS文档库中。

由于官方的中文版本修改一定落后于简体中文计划中所作的变动，因此，我们采用了自己的分支("CNPROJ")而不是CVS默认的“主分支”来进行日常的文档维护。与src/相反，我们的所有改动首先在分支中进行，然后才合并到中央CVS的HEAD分支之上。

现时的FreeBSD文档几乎完全是使用DocBook SGML撰写的，不过幸运的是在翻译文档时，并不需要非常多的这方面的知识。您只需坚守几个主要的原则，就可以在几乎完全不了解SGML的情况下顺利完成翻译。

SGML翻译规则

不要翻译尖括号中的标签名
尽可能保持SGML原有的格式，例如，不要改变缩进量。
所有中文中间的标点必须使用中文标点，而不是,.之类。
中文标点符号后面空格；中文中的英文前后空格。标点符号前面不要空格。
折行只能在可以空格的地方发生。例如，“我爱祖国”这个短语中不允许有任何空格，因此也不可以折行；反之，“我爱五指山，我爱万泉河”这句话，则可以在逗号后面折行。请注意，折行在最终渲染出的版本中将转换为空格。
(by intron)对于索引项，如果能保持其原先的英文首字母，则直接翻译，例如：
<indexterm><primary>PCI Bus</primary></indexterm> ->
<indexterm><primary>PCI 总线</primary></indexterm>；反之，如果翻译成中文时无法保留其英文首字母，则保留英文，将中文加入到随后的括号中：
<indexterm><primary>USB</primary></indexterm> ->
<indexterm><primary>USB (通用串行总线)</primary></indexterm>

翻译注意事项

规范语言：我国是一个幅员辽阔的多民族国家，在不同的地区有不同的方言和语言习惯。尽管我们应尊重各地区的这些语言习惯，但我们的目标是让尽可能多的人能够读懂文档，因此，名词、术语就必须使用通晓的译法。如果一个概念有多种不同的译法，除非有词不达意的情况，否则应尽量使用采用者较多的译法。
语法正确：简体中文文档应使用正确的中文语法；很多英文从句用法会为以中文为母语的读者带来困惑。这是我们的长期改进目标之一。
用字准确：正确使用汉字。例如，不要混淆“的”、“地”、“得”，任何错字、病句一经发现都将在第一时间内被修正。这也是我们的一项长期改进目标。
统一：在所有的中文文档中，专业术语的翻译要保持一致。

配置和获得文档源文件

这篇文档假定您使用的是WinCVS。这一软件是SourceForge上的一个项目，可以从这里下载最新版本。您需要在本地创建一个目录，在我们的例子中，这个目录是C:\FreeBSD_Checkout。在View菜单中选择Browse Location... -> Change...，然后进入这个目录。

配置CVS匿名登录

在Admin菜单中选择Login...，接下来将界面中的CVSROOT改为 :pserver:anoncvs@anoncvs.cn.FreeBSD.org:/home/cnproj 类似下面这样：

按“确定”之后会出现一个询问密码的提示，按回车即可（密码为空）。

请注意，只有在首次使用CVS时才需要登录。CVS会记忆密码。

checkout工作副本

这一操作包括两部分。完成登录之后，在Remote菜单中选择Checkout：

先不要按Ok，在Update options里面选择使用CNPROJ以获取最新版本：

接下来可以按[确定]了。

更新本地副本

FreeBSD中文文档计划是相当活跃的。在开始工作之前，请务必首先更新本地副本，其方法是在对应的目录/文件上面按右键，选择Update。如果希望CVS将之前本地不存在的目录也同步下来，则应选中“Create missing directories that exist in the repository”。更新的快捷键是Ctrl+U。注意：CVS有时无法合并远程和本地的变动，在提交补丁之前，您可能需要手工进行调整。

提交补丁

使用CVS最大的好处是可以直接与文档库中的文件进行比对并产生补丁。最常用的做法是在您修改过的文件上按右键，选择Diff...。为了使您的补丁便于我们直接接受，请选择更适合人类阅读理解的Unified diff格式。

[1] 有更换为subversion的想法和冲动，但目前尚未付诸实际行动。