maven - pom.xml 中的标签注释有何用处？

Question

我目前正在经历https://spring.io/guides/gs/maven/#scratch我刚刚发现

<dependencies>
    <!-- tag::joda[] -->
    <dependency>
        <groupId>joda-time</groupId>
        <artifactId>joda-time</artifactId>
        <version>2.9.2</version>
    </dependency>
    <!-- end::joda[] -->
    <!-- tag::junit[] -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
    <!-- end::junit[] -->
</dependencies>

我想知道:

什么是<!-- tag::joda[] -->有什么好处？

Answer 1

Getting Started Guide您正在阅读的，是从 AsciiDoc 生成的文件:

https://github.com/spring-projects/spring-boot/blob/master/README.adoc

AsciiDoc 是一种与 DocBook XML 等效的文档格式。AsciiDoc 语法允许指向源代码的某些部分，而不是复制粘贴部分源代码。

要包含 pom.xml 的一部分，您可以使用以下语法:

include::complete/pom.xml[tag=joda]

其中将包含代码片段:

<!-- tag::joda[] -->
<dependency>
    <groupId>joda-time</groupId>
    <artifactId>joda-time</artifactId>
    <version>2.9.2</version>
</dependency>
<!-- end::joda[] -->

回答您的问题，<!-- tag::joda[] -->是一个标记，允许 AsciiDoc 提取文件的一部分并将其插入到入门指南中。