出色的医生:从包含的文件中排除零件


 tagName 在一个previous post,我们学习了如何在生成的输出中包含文档的一部分。包含的零件是使用标签定义的。标签的开头在注释中定义,格式为tag::tagName[]结尾有格式end::tagName[]。接下来我们必须使用tags属性include宏,后跟标记名。如果我们不想包含标签,我们必须在它前面加上感叹号(!)。

假设我们有一个外部的Java源,我们想把它包含在我们的Asciidoctor文档中。

package mrhaki;

// tag::singletonAnnotation[]
@Singleton
// end::singletonAnnotation[]
public class Sample {
    public String greeting() {
        return "Hello Asciidoctor";
    }
}


在以下Asciidoctor文档示例中,我们包括Sample.java,但是我们不希望包含包含在singletonAnnotation标签。所以我们使用tags=!singletonAnnotaioninclude宏:

= Sample

To NOT include sections enclosed with tags we must use `tags=!<tagName>` in the `include` directive.

[source,java]
----
include::Sample.java[tags=!singletonAnnotation]
----


当我们将我们的医生标记转换成超文本标记语言时,我们得到了以下结果:

这是1.5.6.1博士写的。