github - 潘多克 : set document title to first title

Question

我正在 github 上创建一个库，所以我为此使用了一个 Markdown 文件，其结构如下:

# My main title
## My first section
...
## My second section
...

但不幸的是，当我使用 pandoc 将此文档转换为 latex 时:

pandoc README.md --number-sections -f markdown -t latex -s -o doc.tex

文档没有任何标题，编号从主标题开始:

1. My main title
1.1. My first section
...
1.2. My second section
...

虽然我想要类似的东西

My main title <=== document title
1. My first section
...
2. My second section
...

我当然可以使用 sed 将所有 ## 更改为 #，并将主标题替换为 % Document My main title但对我来说它看起来很脏。什么是继续的好方法？

谢谢!

Answer 1

注意:此答案适用于 > 2.0 的所有 pandoc 版本，但请参阅 @sww1235 的答案以了解适用于更高 pandoc 版本的更简单方法。

最好使用 pandoc 过滤器来做到这一点。这是一个 Lua 过滤器，可以满足您的需求。将其存储在文件中，例如promote-headers.lua并用 pandoc --lua-filter=promote-headers.lua 调用 pandoc .

local title

-- Promote all headers by one level. Set title from level 1 headers,
-- unless it has been set before.
function promote_header (header)

  if header.level >= 2 then
    header.level = header.level - 1
    return header
  end

  if not title then
    title = header.content
    return {}
  end

  local msg = '[WARNING] title already set; discarding header "%s"\n'
  io.stderr:write(msg:format(pandoc.utils.stringify(header)))
  return {}
end

return {
  {Meta = function (meta) title = meta.title end}, -- init title
  {Header = promote_header},
  {Meta = function (meta) meta.title = title; return meta end}, -- set title
}