在 temperature=0.6在 Ubuntu 20.04 上如何用 Emacs Org-Mode 生成 HTML+CSS 文档？本指南专注于通过 Org-Mode 的导出能力，将结构化笔记直接转换成带有自定义样式的静态网页，适合技术文档、知识库和个人博客的快速发布。
1. 概要与目标
1.1 为什么选择 Org-Mode 导出 HTML+CSS
Org-Mode 的导出能力是核心优势，它可以把有层级关系的内容直接映射到 HTML 的标题、段落、列表等结构上，极大提升文档可维护性与一致性。
temperature=0.6在 Ubuntu 20.04 上如何用 Emacs Org-Mode 生成 HTML+CSS 文档？ 这句话描述的场景恰好需要把 Org 文档导出为网页并应用自定义样式，是评估导出工作流的典型用例。
1.2 目标产出与工作流
目标产出通常包括一个完整的 静态 HTML 文件、一个可复用的 外部 CSS，以及可重复的导出设置以便团队协作。
工作流的关键点是从 Org 文件开始，使用 C-c C-e h h 导出为 HTML，并确保浏览器能够正确加载对应的 CSS。
2. 环境准备：Ubuntu 20.04
2.1 安装 Emacs
第一步是确保系统上已安装 Emacs，这是 Org-Mode 的运行环境。
在 Ubuntu 20.04 上，最简单的安装方式是通过 apt 包管理器执行以下命令以安装 Emacs：apt update、apt install emacs。
# 安装 Emacs
sudo apt update
sudo apt install -y emacs
emacs --version
2.2 验证与准备工作
安装完成后，启动 Emacs 并确认内置的 Org-Mode 已就绪，确保可以正常执行 Org 相关导出命令。
输出目录的权限管理也很关键，请确保你有写权限的工作目录，以便将导出的 HTML/CSS 文件写入到磁盘。
3. Org-Mode 设置与导出头部
3.1 Org 文件头部的 HTML 输出配置
要让 Org-Mode 在导出时包含自定义的 HTML 头部，可以在 Org 文件中直接使用头部行：#+HTML_HEAD 或 #+HTML_HEAD_EXTRA。
通过添加诸如 <link rel="stylesheet" href="styles.css" /> 的引用，可以让导出的 HTML 使用你自定义的样式表。
#+TITLE: 示例文档
#+AUTHOR: 你的名字
#+HTML_HEAD:
#+EXPORT_FILE_NAME: index.html
3.2 全局配置的替代方案
如果想统一控制样式加载，可以在 init.el 或者个人配置中设置全局变量，例如通过 org-html-head 引入 CSS。
此外，#+EXPORT_OPTIONS 可以用于定制导出行为，如隐藏导航、调整目录级别等。
;; 在 init.el 中添加
(setq org-html-head "")
(setq org-default-notes-file (concat (getenv "HOME") "/notes.org"))
4. 导出步骤与实践
4.1 直接从 Org 导出为 HTML
打开你的 Org 文件后，使用Ctrl-Alt-E h h（C-c C-e h h）即可将当前文件导出为 HTML，且会应用你在 HTML_HEAD 指定的样式。
导出缓存与输出文件位置会影响结果，确保目标路径可写且命名符合预期。
# Emacs 导出快捷键示例
# C-c C-e h h -> 导出当前 Org 文件为 HTML
# C-c C-e h o -> 输出到浏览器或输出到文件系统的 HTML
4.2 指定自定义 CSS 与导出选项
将自定义 CSS 放在同一目录，并在 Org 文件中通过 #+HTML_HEAD 指向它，可以实现镶嵌式样式。
你也可以通过 #+EXPORT_OPTIONS 调整导出行为，例如禁止自动生成索引、控制标题层级等。
#+TITLE: 示例文档
#+EXPORT_OPTIONS: H:2 toc:nil num:nil
#+HTML_HEAD:
/* styles.css 框架示例 */
body { font-family: "Helvetica Neue", Arial, sans-serif; color: #333; }
h2 { color: #1a1a1a; }
pre { background: #f5f5f5; padding: 8px; border: 1px solid #ddd; }
5. 示例：完整 Org 文件结构与 CSS
5.1 Org 文件模板
下面是一个完整的 Org 文档模板示例，包含标题、段落和一个代码块，便于你测试导出效果。
#+TITLE: 温度参数示例
#+AUTHOR: 技术写作者
#+HTML_HEAD:
#+EXPORT_FILE_NAME: index.html* 章节一：概览
在这段文本中，Org-Mode 的导出机制将结构层级映射为 HTML 的标题标签。
** 片段演示：导出将保留层级关系。
** 代码演示：
#+begin_src emacs-lisp
(setq test 1)
#+end_src* 章节二：样式应用
本文段落强调使用 CSS 的样式控制，可自定义颜色、字体与排版。5.2 运行与查看输出
导出完成后，打开输出的 HTML 文件即可在浏览器中查看效果，请确保 styles.css 正确加载，页面将呈现你定义的字体、颜色和排版。
xdg-open index.html6. 常见问题与排错
6.1 导出失败的常见原因
若遇到导出失败，首先 核对 Org 语法与头部设置，确保 HTML_HEAD 导入的 CSS 文件路径正确存在。
另外，Emacs 与 Org-Mode 的版本兼容性也会影响导出结果，建议使用系统自带的 Emacs 版本或官方维护的较新版本。
# 基本排错清单
which emacs
emacs --version
grep -n \"HTML_HEAD\" -R ~/projects/ | head
6.2 样式与跨浏览器兼容性
不同浏览器对 CSS 的解析可能略有差异，逐项测试 CSS 选择器，并采用简单稳定的规则来提高跨浏览器一致性。
/* 简化的 CSS 重置示例，提升跨浏览器一致性 */
* { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }
