[MSITE-910] Allow skipping auto-generated breadcrumb item for parent module

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 3.12.1
• Component/s: multi module
• Assignee: Unassigned
• Reporter: Konrad Windszus
• Created: 10/Aug/22 07:21
• Updated: 10/Aug/22 10:39

Description

Currently it is not possible to not render a breadcrumb link for a parent module in a multi module build (https://maven.apache.org/plugins/maven-site-plugin/examples/sitedescriptor.html#Breadcrumbs).

I have the following setup

+ grandparent
   + src/site.xml (containing breadcrumbs)
   + parent
      + mymodule

In such a setup it is impossible to remove breadcrumb being automatically inserted for parent.

Adding another src/site.xml to parent with an empty breadcrumbs section does not help. Adding there at least one item overwrites the breadcrumbs from grandparent (in case the name does not overlap) but this requires to repeat the breadcrumbs from the parent.

Please make the inheritance of breadcrumbs more flexible (similar to https://maven.apache.org/doxia/doxia-sitetools/doxia-decoration-model/decoration.html#menu) to allow to merge breadcrumbs with the parent or to skip automatically adding a breadcrumb.