本文介绍如何通过配置 html-preamble 和 html-preamble-format，在 org mode 导出 html 时自动插入指向父级索引页（superfolder index）的导航栏，无需外部静态站点生成器或复杂 emacs lisp 编程。
本文介绍如何通过配置 html-preamble 和 html-preamble-format，在 org mode 导出 html 时自动插入指向父级索引页（superfolder index）的导航栏，无需外部静态站点生成器或复杂 emacs lisp 编程。
Org Mode 原生导出 HTML 的能力强大，但默认不支持基于目录层级动态生成导航链接（如“返回上级索引”）。不过，借助其内置的 html-preamble 机制，我们可实现轻量、可靠且易于维护的导航方案。
核心思路是：利用 html-preamble 插入固定结构的 HTML 导航栏，并通过 html-preamble-format 控制其内容逻辑。例如，假设你的项目结构如下：
/site/index.html ← 根索引（不显示“上级索引”） /site/blog/index.html ← 博客子站索引 /site/blog/post1.html ← 普通文章页 → 应显示：“首页 | 博客索引” /site/projects/index.html ← 项目索引 /site/projects/app1.org ← 子项目页 → 应显示：“首页 | 项目索引”
你可在 .emacs 或 Org 文件头部添加如下配置：
;; 全局启用（或在 #+PROPERTY: header-args :eval no 中局部启用）
(setq org-html-preamble
(lambda (info)
(let* ((file-path (org-export-get-relative-file-name info))
(dir (file-name-directory file-path))
(is-index (string-match-p "/index\(?:\.org\|\.html\)?$" file-path))
(root-p (string= dir "./"))
(parent-index (if (and (not root-p) (not is-index))
(concat (file-name-as-directory dir) "index.html")
nil)))
(format "<nav class="org-navbar">
<a href="/index.html">? 首页</a>
%s
</nav>"
(if parent-index
(format "<a href="%s">⬆ 上级索引</a>" parent-index)
"")))))✅ 关键说明：
立即学习“前端免费学习笔记（深入）”；
- org-export-get-relative-file-name 获取当前导出文件相对于输出目录的路径（如 "blog/post1.html"），便于推导父目录；
- file-name-directory 提取路径中的目录部分（如 "blog/"），再拼接 "index.html" 得到上级索引地址；
- 使用 string= 判断是否为根目录，避免根 index.html 显示冗余链接；
- is-index 过滤掉 index.html 自身，防止循环跳转（也可按需保留）。
⚠️ 注意事项：
- 此方案适用于扁平或浅层嵌套结构（≤3 层），若需深度递归（如 /a/b/c/d/index.html → 动态生成多级面包屑），则需结合 file-name-directory 多次迭代或使用 split-string 解析路径，此时建议封装为独立函数；
- 若使用 org-publish，请确保该函数在 :html-preamble 属性中正确引用（如 :html-preamble (lambda (info) ...)）；
- 导航样式可通过自定义 CSS 增强，例如添加 .org-navbar { margin-bottom: 1.5em; }。
总结来说，无需引入 Jekyll/Hugo 等工具，也无需从零编写模板引擎——仅靠 Org Mode 的导出钩子与 Elisp 路径处理，即可实现语义清晰、行为可控的层级导航。它平衡了自动化与可读性，是 Org 静态站点工作流中值得推荐的轻量实践。
