发布指将文件复制到目标目录,并可在过程中进行格式转换。默认转换是将 Org 文件导出为 HTML 文件,由函数 org-html-publish-to-html 调用 HTML 导出器完成(参见 HTML Export)。
你也可以使用 org-latex-publish-to-pdf 将内容发布为 PDF,或使用对应函数发布为 ASCII、Texinfo 等格式。
若希望将 Org 文件以 ‘.org’ 格式发布,但移除其中已 归档(archived) 、 已注释(commented) 及 标签排除(tag-excluded) 的树形结构,可使用 org-org-publish-to-org 。
该函数会生成 ‘file.org’ 并存放到发布目录。若需要该文件的网页化版本,可将参数 :htmlized-source 设为 t ,
将在发布目录生成 ‘file.org.html’154。
图片等其他文件仅需复制至发布目标,可使用 org-publish-attachment 实现。对于非 Org 文件,必须指定发布函数:
:publishing-function执行文件发布的函数,也可以是函数列表,所有函数会依次调用。
:htmlized-source非 nil 表示发布源文件的网页化版本。
该函数必须接收三个参数:至少包含 :publishing-directory 属性的属性列表、待发布文件名,以及输出文件的发布目录路径。
函数需读取指定文件,按需执行转换,并将结果写入目标文件夹。