maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John Allen (JIRA)" <>
Subject [jira] Commented: (MNG-3344) Provide new POM element to configure site directory (e.g. "src/site")
Date Sat, 05 Jan 2008 14:01:57 GMT


John Allen commented on MNG-3344:

I think there are a few reporting plugins that have had to rely upon using the default location
hardcoded due to the fact that it was not programmably retrievable from the project model
or the site plugin configuration. will have to fix those up incrementally i guess.

> Provide new POM element to configure site directory (e.g. "src/site")
> ---------------------------------------------------------------------
>                 Key: MNG-3344
>                 URL:
>             Project: Maven 2
>          Issue Type: New Feature
>          Components: POM
>    Affects Versions: 2.0.8
>            Reporter: Benjamin Bentmann
>             Fix For: 2.1-alpha-1
> As requested in MSITE-91 and its various duplicates, the input location for the site
generation should be configurable. Currently, this is realized by a configuration parameter
(siteDirectory) for the maven-site-plugin itself but I argue that this is not sufficient/robust
for all cases. The problem is that the plugin cannot access its configuration in ancestor
POMs and hence can only guess.
> For example, take the following multi-module scenario:
>   project-parent/
>     doc/
>       site.xml
>     project-module/
>       src/
>         site/
>           site.xml
> Let us ignore the fact that such is layout is unusual, weird, bad-practice or whatever
you would like to call it. The point is, it should be possible. The important aspect of the
example is that both POMs will need to use a different configuration of the maven-site-plugin
to find the site descriptor (and related files). The parent POM will have siteDirectory=doc
while the module POM will have siteDirectory=src/site.
> Now consider the plugin's steps when building the site for project-module. From the plugin
configuration in "project-module/pom.xml", it knows to search the site descriptor for the
sub project in "src/site". To apply inheritance, the plugin then needs to locate the site
descriptor of the parent project. Ups. The plugin cannot access the corresponding plugin configuration
in "project-parent/pom.xml". So it can only assume that the parent uses the same directory
layout for the site as the current sub module.
> Having a dedicated POM element for the site files, e.g. ${project.reporting.siteDirectory},
would allow the maven-site-plugin to properly determine the location of the site descriptor
of any ancestor project. The super POM can default this element to "src/site" to get the usual

This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators:
For more information on JIRA, see:


View raw message