补丁 & 提交¶
提交补丁¶
在前几次修改手册时,你需要提交补丁给管理员审查。这只是为了确保用户手册的高品质,以及避免你在熟悉这套系统之前,不小心破坏了一些重要内容。
为了提交补丁,请遵循以下流程:
按照自己的想法进行修改。
创建一个补丁文件,运行:
svn diff > filename.diff
这将创建一个文本,记录对文件进行的添加、删除和修改。
如果您已创建或删除文件,你需要在创建差异文件前,运行
svn add /path/to/file
或者svn rm /path/to/file
。运行svn status
,可以查看受影响的文件列表。在这里上传差异文件 <https://developer.blender.org/differential/diff/create/> `__ 。如果你还没有账号,可以 `注册一个.
提交差异文件后,将要求你 “创建一个新的修改” ,然后就可以添加关于更改的标题和描述。
为了提示文档团队处理你的补丁,注意检查
Tags
文本框是否有指定为文档项目。你也可以在邮件列表或IRC频道 联系 团队。他们将审查你的补丁,告诉你哪些地方还需要修改,或者直接接受并提交你的补丁。
Note
如果你的补丁,包括图片的修改和添加,只需在创建修改时作为附件插入即可。
直截了当的补丁很快就会被接受。一旦你适应了修改流程并且不再需要反馈之后,我们将去掉中间环节,赋予你直接编辑手册的权限。
直接提交¶
提交会将修改直接提交到中央仓库,而不是新建一个补丁文件。
你现在只需运行:
svn commit -m "This is what I did"
如果你省略了 -m "message"
,将提示你再文本编辑器中输入留言。
不要忘记在提交前运行 svn update
。
提交更改之前,会要求你输入用户名(developer.blender.org
)和密码。
你修改过的文件被上传到中央仓库,供其他人继续参与和写作。在仓库的`Diffusion <https://developer.blender.org/diffusion/BM/>`__ 中追踪提交。很快你的修改就会呈现于在线手册中了。