tapestrydoc是一个未知的标签。

Question

我正在开发一个Tapestry组件库，并希望使用maven javadoc插件和Tapestry标签添加javadoc。

我在我的pom.xml中添加了以下内容：

<reporting>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.8.1</version>
            <configuration>
                <linksource>true</linksource>
                <taglet>org.apache.tapestry5.javadoc.TapestryDocTaglet</taglet>
                <tagletArtifact>
                    <groupId>org.apache.tapestry</groupId>
                    <artifactId>tapestry-javadoc</artifactId>
                    <version>${tapestry-release-version}</version>
                </tagletArtifact>
            </configuration>
        </plugin>
    </plugins>
</reporting>

并将以下内容添加到我的组件java类中：

/**
 * @tapestrydoc
 */
public class SomeComponent {
    ...
}

然后我跑了：

mvn javadoc:javadoc

，但得到以下内容：

..。警告- @tapestrydoc是一个未知的标签。

并且组件参数没有添加到javadoc中.

我在这里做错什么了？

Answer 1

请参阅这篇博文中的howto：组件参考文档的JavaDoc插件。您需要将tapestry配置添加到报告插件中。

如果将此配置放入reporting标记中，则仅在通过mvn站点生成报表时才会使用此配置。调用mvn :javadoc不使用报告标记。但是，可以通过将其放入build标记.来轻松地解决问题。

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.8</version>
        <configuration>
          ...
          <taglet>org.apache.tapestry5.javadoc.TapestryDocTaglet</taglet>
          <tagletArtifact>
             <groupId>org.apache.tapestry</groupId>                       
             <artifactId>tapestry-javadoc</artifactId>                       
             <version>5.3-rc-3</version>                   
          </tagletArtifact>
          ...
        </configuration>
      </plugin>
    </plugins>
    ...
  </build>
  ...
</project>