13.9.13 CSS support

可自定义导出文件的 CSS 样式。HTML 导出器会为文档相应部分分配以下专用 CSS 类140,你可修改这些样式,也可使用标题、表格等标准类。

p.author作者信息(含邮箱)
p.date发布日期
p.creator创建工具信息(含 Org mode 版本)
.title文档标题
.subtitle文档副标题
.todoTODO 关键字,所有未完成状态
.doneDONE 关键字,所有已完成状态
.WAITING每个 TODO 关键字会使用自身名称作为类名
.timestamp时间戳
.timestamp-kwd与时间戳关联的关键字,如 ‘SCHEDULED
.timestamp-wrapper包裹关键字与时间戳的层
.tag标题中的标签
._HOME每个标签使用自身名称作为类名,“@” 替换为 “_”
.target链接目标
.linenr代码示例中的行号
.code-highlighted用于高亮引用代码行
div.outline-N第 N 级大纲的框架(标题+正文)
div.outline-text-N第 N 级大纲正文的额外框架
.section-number-N标题中的章节编号,按层级区分
.figure-number图表编号标签,如 “Figure 1:”
.table-number表格编号标签,如 “Table 1:”
.listing-number代码清单编号标签,如 “Listing 1:”
div.figure行内图片的格式化方式
pre.src格式化源代码
pre.example普通示例内容
p.verse诗歌段落
div.footnotes脚注区域标题
p.footnote脚注定义段落
.footref脚注引用编号(始终为 <sup>)
.footnum脚注定义中的编号(始终为 <sup>)
.org-svg链接 ‘.svg’ 图片的默认类名

HTML 导出后端会在每个导出的 HTML 文件中嵌入精简的默认样式。如需使用其他样式覆盖默认样式,可在 Org 文件中使用以下关键字,它们会替换导出器的全局默认样式。

#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="style1.css" />
#+HTML_HEAD_EXTRA: <link rel="alternate stylesheet" type="text/css" href="style2.css" />

To just turn off the default style, customize 如需仅关闭默认样式,可自定义 org-html-head-include-default-style 变量,或在 Org 文件中使用如下选项行:

#+OPTIONS: html-style:nil

对于较长的样式定义,可使用多行 ‘HTML_HEAD’ 与 ‘HTML_HEAD_EXTRA’ 关键字,或用 <style> ... </style> 块包裹,两种方式均可避免依赖外部文件。

如需为子树添加样式,可使用 ‘HTML_CONTAINER_CLASS’ 属性为该子树分配类名。如需为特定标题指定 CSS 样式,可使用 ‘CUSTOM_ID’ 属性中的 ID;也可通过 ‘HTML_HEADLINE_CLASS’ 属性为标题分配专属类名。

请勿修改 org-html-style-default 常量,建议使用上述更简便的自定义方式。


Footnotes

(140)

若 TODO 关键字与标签的类名冲突,可使用变量 org-html-todo-kwd-class-prefixorg-html-tag-class-prefix 确保唯一性。