Tag Library Documentation Generator + Maven

Kolejne narzędzie ułatwiające pracę, a właściwie dwa.

Tag Library Documentation Generator potrafi tworzyć javadoc'a bibliotek tagów JSP na podstawie opisów zawartych w plikach .tld i .tag. Obsługuje tagi JSP 1.2 do 2.1 i JSF.

Na dokładkę plugin do Mavena który generuje dokumentację taglibs automatycznie (korzysta z wymienionego wyżej narzędzia) i załącza do strony projektu - maven-taglib-plugin. Wystarczy wpisać do pom.xml:

<reporting>   <plugins>     <plugin>       <groupId>net.sourceforge.maven-taglib</groupId>       <artifactId>maven-taglib-plugin</artifactId>     </plugin>   </plugins> </reporting>

Plugin udostępnia cele (goals):

• taglib:taglibdoc
• taglib:validate
• taglib:tagreference
• taglib:taglibdocjar
• taglib:tldgenerate

Uruchamianie powyższych bez prefiksu nazwy grupy i pełnej nazwy pluginu - dopisać do settings.xml:

<settings>   ...  <pluginGroups>   <pluginGroup>net.sourceforge.maven-taglib</pluginGroup>  </pluginGroups>   ... </settings>

Linki:

• http://maven-taglib.sourceforge.net/m2/taglibdoc-mojo.html
• https://taglibrarydoc.dev.java.net/