调试Springer Nature期刊Quarto模板的Pandoc Lua过滤器HTML逻辑

核心原因 #

Pandoc（及Quarto）新版本对标题类的处理逻辑有调整：HTML输出流程中，Quarto会基于标题级别、全局配置等重新生成章节的类属性，直接修改标题的classes数组会被后续处理流程覆盖，导致自定义类无法生效。

具体解决步骤 #

1. 调整Lua过滤器的修改方式
   不要直接操作标题的classes数组，而是修改标题的attributes.class字段——Quarto在处理HTML章节时会优先读取这个字段的内容生成最终类。

2. 设置过滤器优先级
   将过滤器的优先级设为高于Quarto的默认处理逻辑，确保你的修改在Quarto处理前生效。

3. 示例修正后的Lua过滤器代码

function Header(el)
  if el.classes:includes("backmatter") then
    if FORMAT:match("latex") then
      -- 保留原LaTeX处理逻辑
      return pandoc.RawBlock("latex", "\\backmatter\n\\bmhead*{" .. pandoc.utils.stringify(el.content) .. "}")
    elseif FORMAT:match("html") then
      -- 追加目标类到attributes.class
      local existing_class = el.attributes.class or ""
      el.attributes.class = existing_class .. " appendix unnumbered"
      -- 可选：移除原backmatter类（按需选择）
      el.classes = el.classes:filter(function(c) return c ~= "backmatter" end)
      return el
    end
  end
end

-- 设置高优先级，确保在Quarto的章节处理前执行
return {
  { Header = Header },
  priority = 100
}

额外检查点 #

• 查看_quarto.yml中的全局配置，比如number-sections是否设为true，这可能会强制覆盖unnumbered类的效果，需要确保该配置不会与你的自定义逻辑冲突。

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