asciidoc - 如何定义自己的 asciidoc 宏

Question

如何在 asciidoc/asciidoctor 中定义宏？

我将在文档的许多部分使用重复模式，因此我想进行参数化替换以避免多次输入相同的内容。

特别是，我有以下 asciidoc 片段：

{set:cellbgcolor:grey}
[grid=none, frame=none]
|===
| X >| Y
|===
{set:cellbgcolor!}

我需要将它放在文档的几个部分中，用不同的文本替换来代替 X 和 Y。我该如何实现呢？

Answer 1

在我看来，Asciidoctor 无法获得其他文档引擎中的所有灵活性/简单性：

• LaTeX 中的命令定义
• MediaWiki 中的模板。

---

我认为您可以使用 Asciidoctor 中的包含宏和变量：

创建一个名为snippet.adoc（我的示例基于您的示例）的文件：

{set:cellbgcolor:grey}
[grid=none, frame=none]
|===
| {paramX} >| {paramY}
|===
{set:cellbgcolor!}

在您的主文档中像这样使用它：

== My document

:paramX: lorem
:paramY: ipsum
include::snippet.adoc[]

Lorem ipsum dolore.

:paramX: aaaa
:paramY: bbbb
include::snippet.adoc[]

Lorem ipsum dolore.

---

也就是说 asciidoctor 可以扩展。您还可以创建自己的真实宏（用 Java 或 Ruby 编写），但这需要更多的工作。根据您的用例，您可以在线找到几个示例。