Versions Compared

Old Version 5

changes.mady.by.user ASF Infrabot

Saved on

compared with

New Version Current

changes.mady.by.user ASF Infrabot

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: converted to 1.6 markup

...

Instructions

  • Download Maven 2.0.2 4 http://maven.apache.org/download.html and install per normal m2 instructions. The site requires Maven 2.0.24, 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 differencesunmigrated-wiki-markup
  • 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 \[http://jira.codehaus.org/browse/MSITE-62 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.unmigrated-wiki-markup
  • The copyright notice at the bottom is now right-aligned (before it was left-aligned) and a bit smaller than before. See \[http://jira.codehaus.org/browse/MSITE-66 MSITE-66\] *SOLVED*
  • There is no text "Doc for <version>" to the right of the publishing date

...

  • If you run into trouble, have a look at the sandbox components exec and openpgp. They are using Maven 2 for site generation.Add the component as a <module> to the <modules> section in <sandbox>/pom.xml
  • Convert <component>/project.xml to <component>/pom.xml. A tool that helps doing this is being worked on by the Maven community. For now you have to do it manually.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.