编辑手册

你可以通过修改本地文件来修改手册。这些文件通过代码仓库与在线文档同步,文档更新正是基于这个服务器。

手册使用 reStructuredText (RST) 标记语言编写,并且可以使用纯文本编辑器编辑。可以将RST文件转换(编译)为HTML网页文件,来进行本地预览。

更新

首先,确保你的本地手册副本与在线资料库是最新的,使用:

  1. make update

编写

现在你可以根据自己的喜好选择文本编辑器编辑文档文件,这些文档位于 manual 文件夹中的 .rst 文件。

请务必检查约定 写作样式指南 ,并 标记样式指南 以了解如何使用 reStructuredText 标记语言编写。

开始写作吧!

较大的修改

如果你打算添加或大修某一节,一定要仔细检查,确保现有手册没有这些内容。在一些地方,文档是如此杂乱无章,以至于一些章节内容重复或者位于某个奇怪的位置。在你找到一个重复或位置不当的章节后,请 新建任务,把问题解释清楚,还可以附带一份修改(真正的更改)。

在你做出一些不那么简单明了的修改(如,移动文件夹)之前,你需要与手册维护人员确认你的贡献与社区对手册的设想是一致的。这能确保你的时间与善意得到最好的利用,否则的话,因为某些原因,你的修改可能会因造成冲突而被驳回或者经历费时的审查。例如,另外一个人可能已经在负责你想要修改的章节,这一节可能已经计划要删除,或者根据Blender的计划变动而相应更新。

提早并频繁地 交流 是维持一个高效环境的关键,这样才不至于浪费别人的努力,并且完成一份更好的Blender手册。

获取帮助/答案

如果你对所要记录的功能存在疑问,你应该向负责这一块的Blender开发人员提出你的疑问,或者在 Blender 讨论 中的非官方用户支持频道 #docs#blender-coders 中提问。

Blender itself has a system of module owners with developer and artist members who are responsible for the design and maintenance of the assigned Blender areas. See the module pages for more information.

预览

要查看您的更改,请构建手册 按照说明 。请记住,您也可以只创建您刚刚编辑的章节,以便快速查看。使用Web浏览器在 “build/html” 文件夹中打开生成的 “.html” 文件,或者刷新已打开的页面。

上传

如果你很满意自己的修改,您可以将它们上传,将其呈现于在线手册中。第一步是提交补丁,从而使他人可以审查你的修改,并给出反馈。之后,你可以直接提交更改。下一节会详细介绍相关流程。