CWDG SVN
Contents
目的
通过使用SVN, 将获得一个版本统一的插件源代码库, 多人之间共享代码将更简便, 并将避免重复开发/汉化插件的问题, 从而有效的控制插件的开发/汉化过程。
SVN地址: http://svn.cwowaddon.com/wow/
帐号
目前SVN帐号只接受论坛中的认证作者, 资深成员, 版主, 超级版主等成员组成员的申请. 申请时请使用论坛短消息给simonw留言, 注明需要申请的SVN用户名和密码. 其他申请方式不再接受.
申请注意事项:
- 你的SVN用户名需要和论坛用户名保持一致(英文用户名情况下), 统一使用全部小写. 当你的论坛用户名为中文时, 请选择一个小写英文用户名提交(SVN不支持中文用户名).
- 你无法自行修改密码, 请勿使用太弱的密码, 如1234, 和用户名一样等.
- 请妥善保管你的帐号, 请勿与他人共享, 否则有可能会被永久封停.
客户端
您可以通过浏览器查看、下载CWDG SVN里的文件，但无法提交文件。
在Windows操作系统下，您可以使用TortoiseSVN在文件夹/文件的右键菜单中进行SVN相关操作，在官方网站下载适合您操作系统的TortoiseSVN版本、中文语言包、中文帮助手册等。
插件检出
安装TortoiseSVN完成后，即可开始检出（Checkout）您需要开发/汉化的插件，以下以TortoiseSVN 1.4.4 32Bit 中文版为例说明。
如图所示，在某文件夹右键选择SVN 检出，在弹出的检出界面输入要检出的插件SVN地址，及检出的本地文件夹，点击确定完成插件的检出。若成功检出插件，则在文件夹上会显示对号标记。
注：插件地址可以使用浏览器访问CWDG SVN来找到该插件所在目录。如http://svn.cwowaddon.com/wow/addons/trunk/BigWigs即为ACE2类插件Beql所在SVN地址。
插件更新
在以后的更新（Update）过程中，您只需在插件的本地文件夹上右键选择SVN 更新即可。
如需了解TortoiseSVN的更多信息，请访问TortoiseSVN -- Windows下的一种Subversion客户端。
CWDG SVN 使用规范
本文列出了各位成员及认证作者使用CWDG SVN管理插件的一些约定，请务必遵守，谢谢您的支持。
本文部分内容参考http://www.wowace.com/wiki/SVN_Rules。
在阅读本文前，根据各位使用者不同的工作重点，请首先阅读SVN的相关内容，包括CWDG SVN、SVN使用入门及SVN使用进阶。
CWTG成员仅要求阅读第一篇文档；认证作者则要求阅读第一、第二两篇文档；CWDG成员三篇文档均需阅读。
我们的原则是：在不影响他人使用的前提下方便自己。
以下约定处于试行阶段，CWDG管理团队有权随时修改以下约定。
检出及更新插件
请勿一次性检出多个目录
与自网页或FTP中下载文件相比，SVN的检出操作需要耗费服务器更多的CPU和内存资源。目前SVN中各类插件资源总计在300MB以上，在您检出整个CWDG项目的过程中，其他成员连接SVN的速度将受到较大的影响。
所以为了保证服务器的稳定工作，建议您找到具体的插件目录来检出，检出步骤见CWDG SVN一文中的插件检出部分。
请勿检出外部引用
理由基本同上，为减轻服务器负担。我们在这里使用svn:externals属性的侧重点在于体现插件与库之间逻辑依赖关系。
请您在检出ACE2类等含有外部引用属性的插件时，勾选省略外部选项。再单独检出CWDG Libs或Lib\ACE2文件。
请勿频繁检出同一目录
理由再同上，为不影响他人使用。如果您需要在本地不同的位置保存同一份插件的检出目录（例：在WoW文件夹里保存一份用于游戏，在插件开发文件夹里保存一份用于开发，在归档文件夹里保存一份用于存档），那么建议您检出该插件一次，再使用操作系统的复制粘贴功能复制到其他位置。
同理，请勿进行类似重复删除某个文件夹再检出的操作。
换种方式更新插件
如果您需要的是一个稳定的、下载后即可使用的插件，那么建议您访问http://file.cwowaddon.com，这里所公布的插件都是经过作者/汉化作者反复测试的，其可靠性远高于SVN里trunk目录的同名插件。
提交插件到SVN
先更新再提交
- 这是进行提交的安全操作，它仅同步其他未修改部分并不会覆盖您本次修改结果。在您的修改部分与SVN内文件对应部分冲突时将给出提示，按照提示解决即可。
一次提交一个插件
- 为了便于他人阅读日志信息，我们建议您在一次的提交过程仅更新一个插件，并注明该插件被修改的具体内容。
插件应导入至合适的目录
同样是为了便于其他成员的查找插件，我们建议您根据插件的种类及开发状态将插件导入到合适的目录中。
例：ChatLog作为ACE2类插件，则应导入至cwdg/Ace2/trunk/目录；而其他非ACE2类插件，则应导入至cwdg/!WoWaddon/trunk/目录。
同一插件的不同版本则应根据开发状态分别导入到trunk、branches、tags目录中，详细信息请参阅SVN使用进阶一文中的分支的使用部分。
提交详细的日志
在您将插件导入、提交、复制分支时请按照相关格式撰写日志信息，使其他成员能够充分了解您的这次提交所改动的具体内容。
当然，您可以在本文规定的基础上添加更加详细的信息。只要不在日志中连载鬼故事就行 ^^
添加必要的SVN属性
这里的属性是指svn:keywords及svn:eol-style，每个汉化文件需设置一个svn:keywords属性，值为Revision Rev Date Author Id；设置一个snv:eol-style属性，值为native。 在汉化文件头部添加如下格式代码；
--[[ Chinese Local : CWDG Translation Team YourName $Rev$ $Date$ ]]
测试通过后再上传
请在翻译完成后在游戏中实地测试插件的大部分功能是否能正确工作，并中文显示效果正确美观，避免频繁提交同一插件。
自行开发的插件则请在能实现基本功能后再导入到SVN中。
请勿擅自修改他人插件
SVN是一个相对开放的源代码库，您可以提交他人开发/汉化的插件修改版本，但请您事先与作者（汉化作者）进行沟通，也许他有自己实现某项功能的方法。
当您负责汉化或开发的插件被人恶意提交时，请与SVN管理员联系，或在CWDG论坛事务版发帖。我们在查清事实后会给与对方一定的制裁。
请勿提交无关文件
我们会定期检查SVN中的文件，若发现与WOW无关内容将立即删除，恕不另行通知，并对提交的作者进行一定的处罚。（比如，罚他(她)翻译10篇语法复杂难以理解的英文资料 ^^）
当您使用CWDG SVN时，则表示您默认遵守如上约定。