在macOS中编译

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

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

  1. make

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

查看本地手册

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

  1. open build/html/index.html

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

编译单个章节

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

  1. make <chapter name>

例如,要编译关于修改器的文档,可使用 make modifiers 。然后打开 build/html/contents_quicky.html 文件就可以查看快速编译的结果。

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


继续下一步: 编辑