在macOS中编译
将rst文件转换为漂亮的HTML页面。
在 ~/blender_docs
文件夹下打开终端,并运行:
这是你每次编译手册都要用到的命令。第一次(或重大变更后)编译过程需要几分钟,但下一次编译就只需几秒钟。
查看本地手册
手册编译结束后,所有HTML文件可以在 ~/blender_docs/build/html
文件夹下找到。尝试在web浏览器中打开 build/html/index.html
并阅读手册:
open build/html/index.html
既然你已经可以编译手册了,下面的篇幅将介绍一种可选的快速编译的方法。
编译单个章节
如果你正在处理手册的某一章节,你可以使用下面的命令快速编译它
例如,要编译关于修改器的文档,可使用 make modifiers
。然后打开 build/html/contents_quicky.html
文件就可以查看快速编译的结果。
这样可以快速编译,但也意味着下一次完整编译所有章节会比较慢。
继续下一步: 编辑 。