14.1.2 Sources and destinations for files

大部分属性为可选,但部分属性建议始终设置。尤其需要让 Org 知晓源文件的查找位置,以及发布文件的存放位置。

:base-directory

存放发布源文件的目录。

:publishing-directory

输出文件的发布目录。你可以使用 Emacs tramp 包适用的文件名语法,直接发布至网页服务器;也可以先发布到本地目录,再通过外部工具上传网站(参见 Uploading Files)。

:preparation-function

发布流程开始前调用的函数或函数列表,例如运行 ‘make’ 更新待发布文件。每个预处理函数均接收单个参数:项目属性列表。

:completion-function

发布流程结束后调用的函数或函数列表,例如修改生成文件的权限。每个完成函数均接收单个参数:项目属性列表。