GitHub Actions部署Hugo站点遇ox-hugo函数未定义错误求助

问题场景 #

通过GitHub Actions部署Hugo站点，流程为：

• 基于Ubuntu环境
• 配置Emacs
• 克隆ox-hugo包
• 通过ox-hugo将.org文件转换为.md文件
• 配置并使用Hugo构建部署

执行第4步时出现错误：

Run emacs ./config.org --batch -L ./ox-hugo -L ox-hugo.el --eval="(org-hugo-export-wim-to-md t)" --kill
Debugger entered--Lisp error: (void-function org-hugo-export-wim-to-md)
  (org-hugo-export-wim-to-md t)
  eval((org-hugo-export-wim-to-md t) t)
  command-line-1(("./config.org" "-L" "./ox-hugo" "-L" "ox-hugo.el" "--eval=(org-hugo-export-wim-to-md t)" "--kill"))
  command-line()
  normal-top-level()

已尝试修改函数参数、包裹表达式，但问题未解决。

错误原因 #

1. 加载路径参数错误：-L ox-hugo.el是无效用法，-L参数用于将目录添加到Emacs加载路径，而非指定单个文件。
2. 未显式加载ox-hugo：即使目录被加入加载路径，也需要通过(require 'ox-hugo)显式加载ox-hugo库，否则Emacs无法识别其中的函数。

解决方案 #

1. 修正Emacs命令 #

将原命令中的错误-L ox-hugo.el移除，并添加加载ox-hugo的语句：

emacs ./config.org --batch -L ./ox-hugo --eval="(require 'ox-hugo)" --eval="(org-hugo-export-wim-to-md t)" --kill

如果需要导出所有子树，使用:all-subtrees参数：

emacs ./config.org --batch -L ./ox-hugo --eval="(require 'ox-hugo)" --eval="(org-hugo-export-wim-to-md :all-subtrees)" --kill

2. 验证ox-hugo克隆路径 #

确保ox-hugo被克隆到了./ox-hugo目录下，且该目录中存在ox-hugo.el文件。如果克隆路径不同，需要对应调整-L后的目录参数。

3. 确保org-mode版本兼容 #

ox-hugo依赖较新版本的org-mode，若Ubuntu默认Emacs的org-mode版本过旧，可在GitHub Actions步骤中安装最新版org-mode：

- name: Install latest org-mode
  run: sudo apt-get update && sudo apt-get install -y org-mode

内容的提问来源于stack exchange，提问作者shweta kadam