Sites and Inheritence

Mavne's support for sites that span multiple projects has generally been limited to date. The following are some features that will assist in this.

Requirements

• Inherited navigational elements
• Ability to generate within the subproject, or at the top level and get the same results (with the exception of aggregated reports)
• No strict requirements on filesystem layout other than those that already exist for Maven projects
• Ability to aggregate reports (individual report technique out of scope here)
• Breadcrumbing

Proposed Solutions

Inherited Navigational Elements

The site descriptor will be deployed to the repository whenever the artifact is (through the deploy phase) or the site is (through the site-deploy phase). It will also be discoverable via the parent POM using ${basedir}/src/site/site.xml using the normal workspace location.

We can add inherit="true|false" to the menu element, with true as the default.

<menu name="Commons Common">
  <item ... />
</menu>

<menu name="Commons Specifics" inherit="false">
  <item ... />
</menu>