14.1.4 Publishing action

发布指将文件复制到目标目录,并可在过程中进行格式转换。默认转换是将 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.html154

图片等其他文件仅需复制至发布目标,可使用 org-publish-attachment 实现。对于非 Org 文件,必须指定发布函数:

:publishing-function

执行文件发布的函数,也可以是函数列表,所有函数会依次调用。

:htmlized-source

nil 表示发布源文件的网页化版本。

该函数必须接收三个参数:至少包含 :publishing-directory 属性的属性列表、待发布文件名,以及输出文件的发布目录路径。 函数需读取指定文件,按需执行转换,并将结果写入目标文件夹。


Footnotes

(154)

若发布目录与源目录相同, ‘file.org’ 会被导出为 ‘file.org.org’ ,因此通常不建议这样做。