Brett Porter has set up the sandbox so that it is possible to use Maven 2 to build the site for commons sandbox components.
Download Maven 2.0.4 http://maven.apache.org/download.html and install per normal m2 instructions. The site requires Maven 2.0.4, it will not work with previous versions.
- Run "mvn site" from trunks-sandbox.
- The maven-site-plugin has not been released yet, so this setup depends on 2.0-SNAPSHOT of that plugin.
- The sites look very similar to the current ones regarding look-and-feel, but there are some small differences
Links to individual components are absolute, both in the menu and in the table, meaning that you can't click on the generated sandbox front page. If you do you end up on the live site. See MSITE-62
- The left hand side menu ends where the menuitems ends. Previously it went on all the way down to where the text in the main area ended. This new behaviour looks better.
The copyright notice at the bottom is now right-aligned (before it was left-aligned) and a bit smaller than before. See MSITE-66 SOLVED
There is no text "Doc for <version>" to the right of the publishing date
Converting from Maven 1
- If you run into trouble, have a look at the sandbox components exec and openpgp. They are using Maven 2 for site generation.
Convert <component>/project.xml to <component>/pom.xml. There is a Maven 2 plugin that helps you do this. Just run this command in the root directory of your component: mvn one:convert
Convert <component>/xdocs/navigation.xml to <component>/src/site/site.xml. They are very similar so there should be no problems.
Move the folder <component>/xdocs/ to <component>/src/site/xdoc/ (Note: the new folder is called xdoc not xdocs). Exclude the file navigation.xml since it is replaced by the file site.xml.