补丁 & 提交¶
提交补丁¶
在前几次修改手册时,你需要提交补丁给管理员审查。这只是为了确保维护的用户手册的高品质,以及避免你在熟悉这套系统之前,不小心破坏了一些重要内容。
为了提交补丁,请遵循以下流程:
按照自己的想法进行修改。
创建一个补丁文件,运行
svn diff > filename.diff
这将创建一个文本,记录你在工作文件和中央仓库之间对文件进行添加、删除和修改的内容。
如果您已创建或删除文件,你需要在创建差异文件前,运行
svn add /path/to/file
或者svn rm /path/to/file
。运行svn status
,可以查看受影响的文件列表。提交差异文件后,将要求你 “创建一个新的修改” ,然后就可以添加关于更改的标题和描述。
为了提示文档团队处理你的补丁,注意检查
Tags
文本框是否有指定为文档项目。你也可以在邮件列表或 Blender Chat 中 联系 团队。They will review your patch and let you know about any changes you could make. If there is no issue, your patch will be accepted and then committed by the team of your patch.
Note
如果你的补丁包含图片的修改和添加,只需在创建修改时作为附件插入即可。
直截了当的补丁很快就会被接受。一旦你适应了修改流程并且不再需要反馈之后,我们将去掉中间环节,赋予你直接编辑手册的权限。
直接提交¶
Once you are provided with the direct access to edit the manual, you can start committing directly instead of creating a patch file. Doing this will submit the change directly to our central repository.
你现在只需运行:
svn commit -m "This is what I did"
如果你省略了 -m "message"
,将提示你在文本编辑器中输入留言。
不要忘记在提交前运行 svn update
。
提交更改之前,会要求你输入用户名(developer.blender.org
)和密码。
你修改过的文件被上传到中央仓库,供其他人继续参与和编写。提交可在仓库的 Diffusion 中追踪。很快你的修改就会呈现于在线手册中了。