如何設置TLDDoc來爲JSP TagLib創建文檔？

Question

我目前工作的一家公司在多個項目中有多個taglibs。我們使用maven和哈德森。我負責發現一些可用於爲我們的taglibs自動生成文檔的東西。我找到了TLDDoc，但我一直無法找到任何解釋如何設置的東西。請注意，我不是Java開發人員，我是一個UI開發人員，可以在JSP和其他技術中工作。任何幫助，將不勝感激。

Answer 1

我有一些類似的要求。我所做的就是在maven文件中使用Ant腳本，它會在我需要的項目下找到所有TLD定義文件，然後遍歷每個文件並執行一些操作。

我需要2個輸出。 HTML和DITA（技術文檔格式，DOCBOOK的繼任者）。

1. 對於每個TLD，都會調用TLDDoc並調用一個相同的輸出目錄。
2. 額外的腳本執行了將TLD xml轉換爲DITA的XSLT樣式表。從DITA我使用「DITA Open Toolkit」輸出爲PDF和另一種類型的HTML。

有了maven，你需要學習一點ANT腳本，並知道如何調用java類（TLDDOC）或XSLT引擎。

這真的很酷，很靈活。

Answer 2

如果你想執行TLDDoc作爲maven插件，你可以這樣做，例如，像這樣：

 <plugin> 
      <groupId>org.codehaus.mojo</groupId> 
      <artifactId>exec-maven-plugin</artifactId> 
      <executions> 
       <execution> 
        <id>generateTldDoc</id> 
        <phase>prepare-package</phase> 
        <goals> 
         <goal>java</goal> 
        </goals> 
        <configuration> 
         <includePluginDependencies>true</includePluginDependencies> 
         <includeProjectDependencies>false</includeProjectDependencies> 
         <mainClass>com.sun.tlddoc.TLDDoc</mainClass> 
         <arguments>     
          <argument>-doctitle</argument> 
          <argument>Whatever Taglib</argument> 
          <argument>-windowtitle</argument> 
          <argument>Whatever Taglib</argument> 
          <argument>-d</argument> 
          <argument>${project.build.directory}/tlddoc</argument> 
          <argument>src/main/resources/META-INF/something.tld</argument> 
          <argument>src/main/resources/META-INF/somethingelse.tld</argument> 
         </arguments> 
        </configuration> 
       </execution> 
      </executions> 
      <dependencies> 
       <dependency> 
        <groupId>taglibrarydoc</groupId> 
        <artifactId>tlddoc</artifactId> 
        <version>1.3</version> 
       </dependency> 
      </dependencies> 
     </plugin>