Pandoc 使用 Lua 过滤器将字符串替换为表格

Question

在我的文档中，我有一个占位符字符串，例如：

{{changelog}}

并且想使用 Lua 过滤器将其替换为 Markdown 格式的表格，如果我使用 HTML，则以下 Lua 过滤器可以工作：

local string = [[
| some | table |
|------|-------|
| val1 | val2  |
]]

string = [[
<table>
    <tr>
        <td>some</td>
        <td>table</td>
    </tr>
    <tr>
        <td>val1</td>
        <td>val2</td>
    </tr>
</table>
]]
function Para(elem)
    if elem.content[1].text == "{{changelog}}" then
        return pandoc.RawBlock('html', string)
      else
        return elem
      end
end

return {{ Para = Para }}

现在这可以使用变量 string 的 HTML 内容，但是如何让它与变量 string 中的 Markdown 格式内容一起使用。

Answer 1

要返回任意格式而不是 HTML，我们必须指示 pandoc 使用 pandoc.read 解析字符串：

function Para(elem)
  if elem.content[1].text == "{{changelog}}" then
    return pandoc.read(tblstring, 'html').blocks
  end
end

pandoc.read 函数接受一个字符串并将其解析为 pandoc 文档，其中第二个参数是格式；我们需要使用访问文档blocks，因为我们对元数据不感兴趣。

我省略了return elem，因为如果函数没有返回值，pandoc 会保留原始元素。

另一种方法是使用pandoc.Table 或pandoc.utils.from_simple_table 等函数构造表，但这通常需要更多工作。

还要注意string 是用于 Lua 字符串库的全局名称，因此最好为表格 HTML 选择不同的名称。