ox-hugo

我在尝试导出形如 [[id:7e29fdd8-b8bc-41c3-9001-a75ba9802758::*CODE][CODE]] 这样的链接的时候，会被认为是 broken link!
只有 id: 和 :: 搭配的时候会出这个问题（不管是指向标题还是模糊匹配），
file: 搭配模糊匹配就不会有问题，我觉得问题出在 ox-hugo 上。

这个标题匹配应该是可以实现的，id 下的 fuzzy link 可能不太容易实现，或许应该 fallback 到最近标题？

TODO 需要支持一下对 ROAM_REFS 的支持

我的链接都是放在这个属性下的，然后这个属性在默认情况下不会被导出，这很不方便

DONE respect org-id-locations-file

为什么 org-hugo-export-wim-to-md 会加载这么多无用的缓冲区？我不理解
他会使用 org-id-locations ，然后我这里这个变量是 nil
调用 org-id-update-id-locations

已合并 kaushalmodi/ox-hugo#770 Respect `org-id-locations-file` by 0WD0

DONE 不知道为什么会同步整个 svg 文件夹

因为可能某种配置下（不是我的配置下） latex 是会被 svg 链接替代的。
我在配置里强制让 org-hugo—copy-ltximg-maybe 为空就能解决问题了:

(after! ox
  (require 'ox-hugo)
  (advice-add 'org-hugo--copy-ltximg-maybe :override (lambda (&rest _) nil)))

DONE 发现了一个巨大 bug

使用子树导出模式时，如果有连向一个文件的根 id 的链接就会解析错误，会有这样的东西：
[Multi-SG](#d41d8c)

从这里看出来问题是遇到了不合法的标题

以文件为单位导出的时候就不会有这个问题，就很奇怪

所以问题是什么？怎么会认为那个标题是空标题的？
提了个 issue：
kaushalmodi/ox-hugo#764 org-roam file-level ID links incorrectly processed in…

已提PR解决：
kaushalmodi/ox-hugo#764 org-roam file-level ID links incorrectly processed in…

Dev Notes

仓库结构一览

ox-hugo.el:767 定义 Hugo 导出后端、选项与元素翻译函数，是整个包的核心导出逻辑。
ox-blackfriday.el:136 提供 Blackfriday 风格的 Markdown 后端，hugo 后端在此之上派生。
ox-hugo-pandoc-cite.el:122 负责可选的 Pandoc 引用处理（运行 pandoc 展开引用后再恢复前置元数据）。
org-hugo-auto-export-mode.el:34 定义自动导出 minor mode，将保存操作钩到 org-hugo-export-wim-to-md。
ox-hugo-deprecated.el 保留旧 API 兼容性。
doc/ 是 Hugo 站点源码，用于生成项目文档；doc/ox-hugo-manual.org 等为手册源。
test/ 包含 ERT 测试与示例 Hugo 站点（test/site），用于回归验证。
Makefile、README.org、CHANGELOG.org 给予构建、说明与变更记录。

主要功能逻辑（导出流程）

用户入口：通过 Org 导出调度或命令调用 org-hugo-export-wim-to-md 、org-hugo-export-to-md 、org-hugo-export-as-md
（ox-hugo.el:4780, 4814, 4869），统一进入 Hugo 导出流程。
导出模式判定：org-hugo-export-wim-to-md 检测当前缓冲是否存在带 EXPORT_FILE_NAME 的有效子树，决定“按子树”或“整文件”导出，支持一次导出全部有效子树
（ox-hugo.el:4869）。
子树/文件导出分支：
- 文件流：org-hugo—export-file-to-md 检查是否有 =#+title=，排除标签后调用核心导出（ox-hugo.el:4449）。
- 子树流：org-hugo—export-subtree-to-md 过滤评论/排除标签，计算菜单或权重所需的子树坐标，然后调用核心导出（ox-hugo.el:4494）。
预处理：若需要跨子树链接重写，会生成轻量 AST 副本并把内部链接改成可解析的文件链接（ox-hugo.el:4624）。
核心导出：org-hugo-export-to-md 组合 Org 环境、选择发布目录，调用 org-export-to-file ‘hugo；org-hugo—before-export-function/org-hugo—after-1-export-function 在前后挂接/卸下临时 advice，记录前置元数据并触发后续处理（ox-hugo.el:1083）。
元素翻译与前置元数据：hugo 后端的 :translate-alist 将关键 Org 元素（headline、src-block、link 等）映射到 Hugo/Markdown 语法；org-hugo-inner-template 等函数在导出主体前生成 TOML/YAML front‑matter（定义同块起始于 ox-hugo.el:767）。
可选引用处理：若启用 HUGO_PANDOC_CITATIONS，org-hugo—after-1-export-function 调用 org-hugo-pandoc-cite—run-pandoc 展开引用并恢复前置元数据格式（ox-hugo-pandoc-cite.el:122）。
收尾：导出全部完成后 org-hugo—after-all-exports-function 清理临时缓冲与计数器（ox-hugo.el:1123）。
自动化：启用 org-hugo-auto-export-mode 时，保存 Org 文件会自动执行“所见即所指”导出（org-hugo-auto-export-mode.el:34）。

Inbox

org-export-define-derived-backend

之后需要看看这个函数怎么用
这应该是 org-export 主要的操作接口

link

_WD_'s Digital Garden

Explorer

ox-hugo

Resources

Manual

Usage

HUGO_BASE_DIR

HUGO_SECTION

EXPORT_FILE_NAME

自动导出

org-hugo-auto-export-mode 有一个很大的问题，我没说要导出的也会被导出！！！

ISSUE

TODO 没有 respect org-link-abbrev-alist

TODO broken-links 默认会被写成 <xxx> 的格式，这不对

TODO EXPORT_FILE_NAME for file export

TODO id broken link 这是非常重要的问题！！！