补丁 & 提交

提交补丁

在前几次修改手册时，你需要提交补丁给管理员审查。这只是为了确保维护的用户手册的高品质，以及避免你在熟悉这套系统之前，不小心破坏了一些重要内容。

为了提交补丁，请遵循以下流程：

  1. 按照自己的想法进行修改。

  2. 创建一个补丁文件，运行

    1. svn diff > filename.diff

    这将创建一个文本，记录你在工作文件和中央仓库之间对文件进行添加、删除和修改的内容。

    如果您已创建或删除文件，你需要在创建差异文件前，运行 svn add /path/to/file 或者 svn rm /path/to/file 。运行 svn status ，可以查看受影响的文件列表。

  3. 在这里上传差异文件 。如果你还没有账号，可以 注册一个 。

  4. 提交差异文件后，将要求你 “创建一个新的修改” ，然后就可以添加关于更改的标题和描述。

  5. 为了提示文档团队处理你的补丁，注意检查 Tags 文本框是否有指定为文档项目。你也可以在邮件列表或 Blender Chat 中 联系 团队。

  6. 他们将审核你的补丁并告知你还需修改的的地方，或者如果补丁被接受，则提交补丁。

Note

如果你的补丁包含图片的修改和添加，只需在创建修改时作为附件插入即可。

直截了当的补丁很快就会被接受。一旦你适应了修改流程并且不再需要反馈之后，我们将去掉中间环节，赋予你直接编辑手册的权限。

直接提交

提交会将修改直接提交到中央仓库，而不是新建一个补丁文件。

你现在只需运行:

  1. svn commit -m "This is what I did"

如果你省略了 -m "message" ，将提示你在文本编辑器中输入留言。

不要忘记在提交前运行 svn update 。

提交更改之前，会要求你输入用户名(developer.blender.org)和密码。

你修改过的文件被上传到中央仓库，供其他人继续参与和编写。提交可在仓库的 Diffusion 中追踪。很快你的修改就会呈现于在线手册中了。