使用 Maven Javadoc 插件生成多个 TLD顶级域名生成器

Question

我有一个 taglib 项目，我使用 TLDGen 库来帮助构建我的 TLD 文件我的课程中的注释。然后，我将其插入 Maven JavaDoc 插件，以使其通过 javadoc:javadoc Maven 目标构建 TLD 文件。处理这个问题的 Pom 部分如下：

<build>
    ...
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.7</version>
            <configuration>
                <doclet>org.tldgen.TldDoclet</doclet>
                <docletArtifact>
                    <groupId>com.google.code.tldgen</groupId>
                    <artifactId>tldgen-all</artifactId>
                    <version>1.0.0</version>
                </docletArtifact>
                <show>private</show>
                <additionalparam>-name test
                    -uri "http://www.mycompany.com/tags/wibble"
                    -tldFile ..\..\..\src\main\resources\META-INF\w.tld
                </additionalparam>
                <useStandardDocletOptions>true</useStandardDocletOptions>
                <author>false</author>
                <encoding>utf-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>

这非常有效。问题是我知道想要从这个项目创建 2 个 TLD。我可以在 addtionalparam 元素中传递 -subpackages 属性，这样我就可以生成一个完全符合我想要的 TLD。

但此时我只能有一个配置元素。我尝试将配置移动到我的 pom 中带有两个报告集的报告部分，看看是否有帮助，但没有运气。

有没有人曾经尝试过这个，并且可以帮助我指出正确的方向以使其正确？干杯!

Answer 1

这个问题发布已经有一段时间了，但以下是我如何使用 TLDGen 生成多个 tld。我从你的问题开始，因为项目中的人使用你的答案作为参考:)。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.7</version>
    <configuration>
        <includes>
            <include>**</include>
        </includes>
        <doclet>org.tldgen.TldDoclet</doclet>
        <docletArtifacts>
            <!-- listing all dependencies for tldgen: 
            the tldgen library, commons-logging, commons-io, 
            commons-lang, geronimo-jsp_2.1_spec, log4j, saxon, stax
            not sure if they have to be listed here, will have to check; if I
            don't set them I get class not found errors, but I'm guessing I 
            have a misconfiguration -->
        </docletArtifacts>
        <show>private</show>
        <additionalparam>
            -htmlFolder ${basedir}/target/docs
            -tldFolder ${basedir}/src/main/java/META-INF
            -license NONE
        </additionalparam>
        <useStandardDocletOptions>true</useStandardDocletOptions>
        <author>false</author>
        <encoding>utf-8</encoding>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jsr173_api</artifactId>
            <version>1.0</version>
        </dependency>
    </dependencies>
    <executions>
        <execution>
            <phase>generate-resources</phase>                            
            <goals>
                <goal>javadoc</goal>
            </goals>
        </execution>
    </executions>
</plugin>