在Asciidoctor中自动编号的标注

Asciidoctor 1.5.8具有一个非常好的功能，称为自动编号标注，因此您不必指定标注的编号，而只需指定通用字符（。），然后在渲染时，Ascidoctor将正确设置名称。

请参见下一个示例，其中显示了标注的编号和自动编号功能：

= My Code
:source-highlighter: highlightjs 

== Callouts

[source, java]
.MyClass.java
----
public class MyClass { // <1>
  public static void main(String[] args) { // <2>
    System.out.println("Hello World"); // <3>
  }

}
----
<1> Class name
<2> Entry point for a runnable JAR
<3> Prints to console

== Autonumber callout

[source, java]
.MyClass.java
----
public class MyClass { // <.>
  public static void main(String[] args) { // <.>
    System.out.println("Hello World"); // <.>
  }

}
----
<.> Class name
<.> Entry point for a runnable JAR
<.> Prints to console

输出看起来像：

因此，您可以看到两种情况下的输出完全相同，但是在第一种情况下，标注的编号是静态的，而在第二种情况下，则使用了自动编号功能。

当您有很多代码块时，可能会在已经定义的标注中引入一些标注，这意味着将它们全部转移，因此使用自动编号功能非常有用。

同时，采用第一种方法意味着您需要转到每个标注并手动增加编号，在后一种方法中，您仅需要添加一个新标注，仅此而已，就无需手动增加标注编号。

我们不断学习，

亚历克斯

我的身体在燃烧，它开始大喊，欲望来了，它大声爆发（摇滚乐像飓风–蝎子）

翻译自: https://www.javacodegeeks.com/2019/01/auto-numbered-callouts-asciidoctor.html