MavenMultiProjectSite

HomePage | RecentChanges | Preferences

Converting the Struts site

  1. Copy everything from /struts/current/core/doc/ to /struts/current/site/xdocs/
  2. Rename the project.xml files (which contain the menus) to navigation.xml
  3. Change links in all navigation.xml files under 'build' to be relative to the root directory
  4. Add the missing <body> tags to navigation.xml files
  5. Add navigation.xml files to xdocs under each subproject
  6. Change the <chapter> tags to <section> and <section> to <subsection> in the userGuide
  7. Remove the <search> section from userGuide/index.xml and faqs/index.xml
  8. Fix links to Taglib Package Descriptions in the User Guide
  9. Fix links to Taglib API References in the User Guide

Draft site: http://svn.apache.org/builds/struts/maven/trunk/site-test/index.html

Discussion thread: http://www.mail-archive.com/dev%40struts.apache.org/msg10723.html

TODO List

Done

Notes

References


August 8, 2005 Problem with maven multiproject:site

$ maven multiproject:site > ../../mp-site.log

BUILD FAILED
File...... C:\Documents and Settings\wendy\.maven\cache\maven-xdoc-plugin-1.8\plugin.jelly
Element... j:include
Line...... 365
Column.... 54
file:/C:/Documents and Settings/wendy/.maven/cache/maven-xdoc-plugin-1.8/plugin-
resources/site.jsl:33:15: <jsl:stylesheet> file:/C:/Documents and Settings/wendy
/.maven/cache/maven-xdoc-plugin-1.8/plugin-resources/site.jsl:161:65: <jsl:apply
Templates> file:/C:/Documents and Settings/wendy/.maven/cache/maven-xdoc-plugin-
1.8/plugin-resources/site.jsl:239:50: <jsl:applyTemplates> file:/C:/Documents an
d Settings/wendy/.maven/cache/maven-xdoc-plugin-1.8/plugin-resources/site.jsl:25
4:48: <x:set> Property 'var' has no write method

wendy@imbrium-1 /cygdrive/e/svn/struts/current/build
$

Possible Solution

Visited http://maven.apache.org/reference/plugins/xdoc/ and determined that the xdoc plugin is now at version 1.9.1. Download maven-xdoc-plugin-1.9.1.jar and placed in $MAVEN_HOME/plugins, and re-run maven multiproject:site.

Different Problem

wendy@imbrium-1 /cygdrive/e/svn/struts/current/build
$ maven multiproject:site > ../../mp-site.log

BUILD FAILED
File...... C:\Documents and Settings\wendy\.maven\cache\maven-xdoc-plugin-1.9.1\plugin.jelly
Element... echo
Line...... 554
Column.... 75
java.lang.reflect.InvocationTargetException

wendy@imbrium-1 /cygdrive/e/svn/struts/current/build
$

Tried it in Windows (instead of Cygwin)

multiproject:projects-init:

multiproject:site-init:

multiproject:create-nav:
    [echo] Producing aggregate navigation...
    [echo] Producing user supplied navigation...

BUILD FAILED
File...... C:\Documents and Settings\wendy\.maven\cache\maven-multiproject-plugi
n-1.3.1\plugin.jelly
Element... velocity:merge
Line...... 169
Column.... 11
java.lang.OutOfMemoryError
Total time: 10 minutes 1 seconds
Finished at: Mon Aug 08 16:56:09 MST 2005

E:\svn\struts\current\build>

So close! Try this: http://swc.projects.semwebcentral.org/util/maven-setup/build-maven.html

there is currently a problem compiling all the plugin docs due to an OutOfMemoryError.
as a workaround, make the following change to MAVEN_HOME/bin/maven.bat
REM SET MAVEN_OPTS=-Xmx128m
SET MAVEN_OPTS=-Xmx1024m

The line in maven.bat is now

@REM Reaching here means variables are defined and arguments have been captured
:endInit
if "%MAVEN_OPTS%"=="" SET MAVEN_OPTS="-Xmx256m"
So it should respect an environment variable set before calling maven.

E:\svn\struts\current\build>set MAVEN_OPTS=-Xmx1024m

E:\svn\struts\current\build>echo %MAVEN_OPTS%
-Xmx1024m

E:\svn\struts\current\build>maven multiproject:site > ../../mp-site.log
Note: Some input files use or override a deprecated API.
Note: Recompile with -deprecation for details.
...
E:\svn\struts\current\build>

From mp-site.log

BUILD SUCCESSFUL
Total time: 9 minutes 30 seconds
Finished at: Mon Aug 08 17:16:58 MST 2005

Success!


HomePage | RecentChanges | Preferences
This page is read-only | View other revisions
Last edited August 21, 2005 7:31 am by WendySmoak (diff)
Search: