asciidoc宏

Question

我使用 asciidoc 来渲染文本。

我很难理解宏。我的目标是进行简单的宏处理(就像在 LaTeX 中一样)。我想写两个宏:

1. FOO 应替换为 "bar"
2. MYTEXT(xyz) 应替换为:“这是我的文本 xyz!”
   (也许用不同的方式传递参数“xyz”)

示例文件 abc.txt:

text text text
FOO text FOO
text text text
MYTEXT(jajaja)

这应该导致

text text text
bar text bar
text text text
This is my text jajaja!

我希望FOO和MYTEXT的定义必须进入文件abc.conf；可能进入[宏]部分。

附加问题:

模式匹配是否有问题，如果FOO 应该替换为 'bar'，FOOX 应该替换为 'barbar'？

Answer 1

对于将 FOO 替换为 bar 并将 FOOX 替换为 barbar 的任务，我将使用替换语法:

= AsciiDoc title
:FOO: bar
:FOOX: barbar

Regular text here using substitutions: {FOO} is bar and {FOOX} is barbar.

如您所见，您将替换声明为 :VARIABLE:然后将其用作 {VARIABLE} .

对于实际创建新的宏，宏通常是 macroname:content[Text input] 类型。 。它们被记录在案here对于 Python AsciiDoc 项目，最终 here对于基于 ruby​​ 的 AsciiDoctor 项目，但我从未真正使用过它们，我更喜欢替换和条件 block 。