[DOXIASITETOOLS-330] Option to ignore parent site.xml or override XML elements like breadcrumbs and links

[jira-importer]

Alexander Kriegisch opened DOXIASITETOOLS-330 and commented

I have a use case in which I want to use a parent POM, because its defined dependencies and plugins are exactly what I need. However, the parent POM has a site.xml attached which I would like to completely replace, not inherit. As that does not seem to be possible, at least I need to override some existing entries of the site structure. While some like bannerLeft can just be redefined, there is no way to remove them completely. Especially annoying in my use case is the fact that I cannot override parent breadcrumbs.

As you can see here and here, method ‎DefaultSiteModelInheritanceAssembler::mergeLinkItemLists only permits limited interactions with parent breadcrumbs, i.e. I can copy the first one (which I want to get rid of, too) and cut off after that. But this is not what I need.

What I need at least, is to be able to use something like <breadcrumbs combine.self="override">, similar to Maven plugin configurations. Better still would be an option to use that in all tags on all levels or an option exposable to Maven Site to generally ignore a parent site.xml.

---

Affects: 2.0.0-M16

[kwin]

Complete override is already possible with site combine.self="override

Using something more granular for links would require changes in https://github.com/apache/maven-doxia-sitetools/blob/master/doxia-site-model/src/main/java/org/apache/maven/doxia/site/inheritance/DefaultSiteModelInheritanceAssembler.java and also mentioning the inheritance attributes in the Site Descriptor documentation.

Note that the advanced inheritance rules in POM are only supported for plugin configuration which works kind of outside what is generated by Modello (https://github.com/apache/maven/blob/e6fb273a0d3bf70fb1e6e04772aea86015c528e3/api/maven-api-model/src/main/mdo/maven.mdo#L2549-L2582)