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>