如何定义自己的asciidoc宏

时间:2016-05-19 17:27:16

标签: asciidoc asciidoctor

如何在asciidoc / asciidoctor中定义宏?

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

特别是,我有以下asciidoc片段:

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

我需要将它放在文档的几个部分中,用不同的文本替换代替X和Y.我如何实现?

1 个答案:

答案 0 :(得分:4)

在我看来,你没有使用Asciidoctor在其他文档引擎中获得的所有灵活性/简单性:

  • LaTeX中的命令定义
  • MediaWiki中的
  • Templates

我认为您可以使用Asciidoctor中的include宏和变量:

创建一个名为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编写),但这需要更多的工作。根据您的使用情况,您可以在线找到几个示例。