在macOS中编译

将rst文件转换为漂亮的HTML页面。

~/blender_docs 文件夹下打开终端,并运行:

make

这是你每次编译手册都要用到的命令。第一次(或重大变更后)编译过程需要几分钟,但下一次编译就只需几秒钟。

查看本地手册

手册编译结束后, 可以在 ~/blender_docs/build/html 文件夹下找到编译的HTML文件。尝试在浏览器中打开 build/html/contents.html 并阅读手册:

open build/html/contents.html

既然你已经可以编译手册了,下面的篇幅将介绍一种快速编译的方法。

编译单个章节

如果你正在处理某一章节的手册,你可以使用下面的命令快速编译手册

make <chapter name>

例如,要编译修改器的文档,就使用 make modifiers 。你接下来就可以打开 build/html/contents_quicky.html 文件预览快速编译的结果了。

这样可以快速编译,但也意味着下一次完整编译所有章节会比较慢。


继续下一步: 编辑