Asciidoc:如何获取页眉和页脚？

Question

是否有正确的方法让 Asciidoc 包含页眉和页脚？

我正在尝试确定 Asciidoc 是否是打印 Material 的有力竞争者。我知道它应该与 docbook 兼容，但我不知道如何创建章节、页眉和页脚。

我正在尝试创建教学 Material 。目前，我使用带有 asciidoc 插件的 Atom 创建文本，并在 Mac 上使用 Marked 2 以获得更好的外观并将其导出为 PDF。

Answer 1

运行页眉和页脚不是 AsciiDoc 语言的一部分，而是您用于 PDF 转换的工具。在我看来，您(至少)有 2 个选择:

1. 按照Marked 2用户手册导出打印/PDF中的说明创建页眉和页脚(使用 AsciiDoc 处理器而不是 MultiMarkdown 可能会很困难).

"You can specify headers and footers on a per-document basis using MultiMarkdown metadata at the very top of the document"

1. 因为您可能已经安装了 Asciidoctor 以支持 Marked 2 中的 asciidoc，您可以使用 Asciidoctor PDF theme使用 Asciidoctor PDF 生成带有页眉/页脚的 PDF .不过，您必须找到一个合适的主题或自己创建一个。

然而，最常用的生成 PDF 输出的方法似乎是先生成 DocBook 输出，然后使用 dblatex 和 DocBook XSL 样式表将其转换为 PDF (参见 AsciiDoc 主页)。也许其他人可以就此说更多。