maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Christian Schulte (JIRA)" <>
Subject [jira] (MSITE-659) 'relativizeDecorationLinks' relativizes too much.
Date Sun, 14 Oct 2012 12:54:36 GMT


Christian Schulte updated MSITE-659:


Another example project demonstrating the issue. Unzip and execute 'mvn site'. Open 'target/site/index.html'
from the parent project in a browser. The 'Inside Parent Jar' link got relativized correctly
- that link is working ok at the deployed location and also inside the parent jar file. Now
open the 'child/target/site/index.html' from the child project in a browser. The inherited
'Inside Parent Jar' link got relativized correctly but that link only works when actually
deployed to a web server. It is not working inside the jar where it should be an absolute
link. Absolute link in the jar - relative link in the deployed web site. Now repeat the above
with the 'relativizeDecorationLinks' parameter set to 'false' (mvn clean site -DrelativizeDecorationLinks=false).
The 'Inside Parent Jar' link in the 'target/site/index.html' from the parent site now is kept
absolute. This is kind of useless in the parent site jar and in the deployed web site. That
same link in the 'child/target/site/index.html' from the child site is absolute in the child.
That link now is working in the child site jar file (when unzipped and used locally) but is
again kind of useless in the deployed web site.

To sum this up. There is nothing wrong with the 'relativizeDecorationLinks' feature when building
a web-site you are actually going to deploy somewhere. The problem is when building a jar
for use locally. Relative links pointing outside the jar file will not work there and need
to be kept absolute and absolute links which are pointing to content inside the jar file should
be relative otherwise the jar is quite useless.

> 'relativizeDecorationLinks' relativizes too much.
> -------------------------------------------------
>                 Key: MSITE-659
>                 URL:
>             Project: Maven 2.x and 3.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>    Affects Versions: 3.1
>            Reporter: Christian Schulte
>         Attachments:,,
> When relativizing links, the plugin produces relative links to content not generated
by the plugin which should be kept absolute.

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:!default.jspa
For more information on JIRA, see:


View raw message