Asciidoc - Include mit "Tags"

02 April 2023

Quellcodeabschnitte werden mit Kommentarzeichen und "tag:name[]", bzw. "end:name[]" unterteilt.

HelloWorld.java

public class HelloWorld {
    // tag::mainMethod[]
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
    // end::mainMethod[]
}

Der tag-Abschnitt kann dann im Asciidoc-Test eingefügt werden

 [source,java]
 ----
 include::HelloWorld.java[tags=mainMethod]
 ----

das ergibt dann in der Dokumentation

Text vor dem Tag
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
Text nach dem Tag