The maven site command allows you to generate project documentation, as explained in an earlier post for maven 2.0.
Running mvn:site with Maven version 2.1, I had some problems however:
- site plugin version error
SiteToolException: ArtifactNotFoundException: The skin does not exist: Un able to determine the release version
Apparently the skin plugin does not install automatically with a version, so force the issue, from the command line:$ svn checkout http://svn.apache.org/repos/asf/maven/skins/trunk/
$ cd trunk
$ mvn install -DupdateReleaseInfo=true - doxia ArrayIndexOutOfBoundsException
[WARNING] Deprecated API called - not org.apache.maven.doxia.sink.Sink
This error is caused by some maven/module version mismatches.
instance and no SinkFactory available. Please update this plugin.
[INFO] ------------------------------------------------------------------------
[ERROR] FATAL ERROR
[INFO] ------------------------------------------------------------------------
[INFO] 1
[INFO] ------------------------------------------------------------------------
[DEBUG] Trace
java.lang.ArrayIndexOutOfBoundsException: 1
at org.apache.maven.doxia.module.xhtml.XhtmlSink.tableCell(XhtmlSink.java:791)
To solve this second issue, add a <pluginManagement> element under the build element to set compatible versions. <pluginManagement> has a <plugins> child element. Do not confuse this with the <plugins> child of the <buid> element.
This modification takes care of the exception, and your documentation generation will succeed. The [WARNING]s above, however, will remain.1234567891011121314151617181920212223242526272829<project>...<build><pluginManagement><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-site-plugin</artifactId><version>2.1.1</version><dependencies><dependency><groupId>commons-httpclient</groupId><artifactId>commons-httpclient</artifactId><version>3.1</version><exclusions><exclusion><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId></exclusion></exclusions></dependency></dependencies></plugin></plugins></pluginManagement>...</build>...</project>
Posts
