【问题标题】:Multi-paragraph attribute in AsciiDocAsciiDoc 中的多段属性
【发布时间】:2016-02-25 22:33:59
【问题描述】:

我有一个经常重复的两段文字。如何避免重复?

现在我有:

:something-1: Blah blah blah +
blah blah blah +
blah blah blah

:something-2: Blah blah blah +
blah blah blah +
blah blah blah

然后:

--
{something-1}

{something-2}
--

有没有办法可以将两个段落放在一个属性中?如果我也可以将块放入属性中会更好。

这不起作用:

:something: Blah blah blah +
blah blah blah +
blah blah blah +
+
Blah blah blah +
blah blah blah +
blah blah blah

空行和第二段的加号不作为属性定义的一部分进行解析。

另一种选择是将两个段落放在一个单独的文件中并使用include: 宏。但是每次我遇到这个问题时创建一个单独的文件会造成一些混乱。这也使得从 1 段定义变为 2 段定义变得比必要更难。我宁愿有一个包含所有这些重复术语定义的“词汇表”部分(或文档)。

【问题讨论】:

    标签: asciidoc asciidoctor


    【解决方案1】:

    我不知道是否可以使用多段属性,但selective imports 绝对可以!我现在有一个glossary.asciidoc 文件:

    tag::something[]
    --
    Blah blah blah
    
    Blah blah blah
    --
    end::something[]
    

    我可以通过以下方式导入此部分:

    include::glossary.asciidoc[tag=something]
    

    这种方法的一个主要优点是可以在 sn-p 中进行文本格式化。

    【讨论】:

    • 我会说这可能是最好的方法,除非你想创建一个可以生成内容的扩展。
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2017-06-24
    • 1970-01-01
    • 1970-01-01
    • 2017-08-11
    • 1970-01-01
    相关资源
    最近更新 更多