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 Plugin For Component Reference Documentation。 您需要將tapestry配置添加到報告插件。

如果將此配置放入報告標記中，則只有在通過mvn站點生成報告時纔會使用該配置。調用mvn javadoc：javadoc不使用報告標記。 但是，您可以通過將其放入構建標籤來輕鬆解決您的問題。

<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>