...
When generated within the subproject, it is only generated into the subproject. The site will appear correctly, but navigating to upper levels will not be possible when previewing. However, it can be deployed from there directly into the right subdirectory on the site.
Filesystem layout constraints
The location of site.xml
relative to a project is determined by plugin configuration as normal, and defaults to src/site
. When locating a parent project, this is done using the normal workspaces/USD technique (using relativePath
in the POM, falling back to the repository. Parent project documents are not needed - only the site descriptor.
Breadcrumbing
Breadcrumbs will be stored in the <breadcrumbs />
element.
Report aggregation
Most of the work of this is covered in the individual plugins and the Maven Dashboard discussion. When running the site from the top level, it behaves as an @aggregator
so that it is repsonsible for generating all of the child projects, rather than using the reactor to do so. This will enable final aggregation.