可自定义导出文件的 CSS 样式。HTML 导出器会为文档相应部分分配以下专用 CSS 类140,你可修改这些样式,也可使用标题、表格等标准类。
p.author | 作者信息(含邮箱) |
p.date | 发布日期 |
p.creator | 创建工具信息(含 Org mode 版本) |
.title | 文档标题 |
.subtitle | 文档副标题 |
.todo | TODO 关键字,所有未完成状态 |
.done | DONE 关键字,所有已完成状态 |
.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 常量,建议使用上述更简便的自定义方式。
若 TODO 关键字与标签的类名冲突,可使用变量 org-html-todo-kwd-class-prefix 与 org-html-tag-class-prefix 确保唯一性。