[jira] Created: (MSITE-159) Absolute URI rendered as relative URI if absolute URI related to domain of POM URI

Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
----------------------------------------------------------------------------------

         Key: MSITE-159
         URL: http://jira.codehaus.org/browse/MSITE-159
     Project: Maven 2.x Site Plugin
        Type: Bug

    Reporter: Ted Husted


Under site-beta5

if the POM references a URI like

  <url>http://struts.apache.org</url>

absolute URLs used in the site.xml file are converted to relative references.

For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
just "http://struts.apache.org" becomes an empty string.  

If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.

Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.

Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.




--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira

    [ http://jira.codehaus.org/browse/MSITE-159?page=comments#action_79349 ]
           
John Allen commented on MSITE-159:
----------------------------------

relative paths were partially supported in beta-4 however the logic did not resolve sibling paths with a common ancestor. Maybe offline generation (i.e. preserving URLs) should be a command line option as relatives make it possible to do many things such as stage a web site and check that links are valid BEFORE deployment to the target location.

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=comments#action_80660 ]
           
Kay Grosskop commented on MSITE-159:
------------------------------------

Moreover the current behaviour of the site generation leads to the following annoying issue:
pom:
<url>https://bla.mycomp.nl</url>
<distributionManagement><site><url>scp://mycomp.nl/home/groups/bla/htdocs/site</url></site></distributionManagement>
(where the project url is mapped to the htdocs directory)
site.xml:
<menu name="Docs"><item name="Document share" href="https://bla.mycomp.nl/docs"/>

In this case, the it will create a relative link to href="docs". but since my site gets deployed in subdirectory ./site it will point erroneously to ./site/docs

Now you can argue that the project-url is meant to point to the root of the site deployment location.
But in my opinion absolute paths should stay absolute. Isn't that the reason why you define them absolute, because you want to overrule the relation with the deployment url?

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_103012 ]

John Allen commented on MSITE-159:
----------------------------------

Re isnt that why you define them as absolute? Well yes but also not really, a project's URL is absolute as it is its published external web address accessible from anywhere. I can depend on your project and will want to link to it and will need this to see your site. If you made your sub-modules use explicitly defined relative URLs then they would never be accessible to anyone other than your related site pages (ie parent/children). We find it easier to generate our offline docs using relatives as well via the site:stage mojo - this lets us create a completely self referential site without having the browser try and jump online all the time.

I expect the real answer to these 'i dont like', 'i do like' issues with relative URLs is to make it a configuration option :)

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_103012 ]

John Allen edited comment on MSITE-159 at 7/23/07 12:48 PM:
------------------------------------------------------------

IMHO a project.URL is supposed to point to the web accessible location for that project and thus yes there is tight coupling between the distroManagement.site.url and the project.URL. If one wants to redirect/map via web mechanism the project.URL to some other web location then that's fine too. (i.e. redirect your htdocs requests to htdocs/site)

Re isnt that why you define them as absolute? Well yes but also not really, a project's URL is absolute as it is its published external web address accessible from anywhere for that artifact. I can depend on your project and will want to link to its web materials. If you made your sub-modules use explicitly defined relative URLs then they would never be accessible to anyone other than your related site pages (ie parent/children).

Re offline - We find it easier to generate our offline docs using these auto-generated relative URLs, we get a sompletely self referential site and the browser doesnt try and jump online all the time.

I expect the real answer to these 'i dont like', 'i do like' issues with relative URLs is to make it a configuration option :)


 was:
Re isnt that why you define them as absolute? Well yes but also not really, a project's URL is absolute as it is its published external web address accessible from anywhere. I can depend on your project and will want to link to it and will need this to see your site. If you made your sub-modules use explicitly defined relative URLs then they would never be accessible to anyone other than your related site pages (ie parent/children). We find it easier to generate our offline docs using relatives as well via the site:stage mojo - this lets us create a completely self referential site without having the browser try and jump online all the time.

I expect the real answer to these 'i dont like', 'i do like' issues with relative URLs is to make it a configuration option :)

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_103036 ]

Ted Husted commented on MSITE-159:
----------------------------------

If the configuration option said "render absolute URLs absolute," then yes, that would be helpful.

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_103352 ]

John Allen commented on MSITE-159:
----------------------------------

I think something along the lines of 'convert URLs to relative URLs where possible' is sensible.

Note that even relatives can be converted into better relatives. i.e.

foo/bar/../../foo/bar/../ is the same as ..

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

     [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dennis Lundberg updated MSITE-159:
----------------------------------

    Component/s: relative links

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_123752 ]

Ramon Havermans commented on MSITE-159:
---------------------------------------

I think it should work what one would expect. In HTML there is absolute and relative. Don't translate it.

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_123756 ]

Kay Grosskop commented on MSITE-159:
------------------------------------

(John, sorry for my late reaction.)

You are right: the internal references of the generated site should work wherever its build. Thats why the url's should be relative there.

BUT: in the example above the point to use an absolute url is, that it refers to an EXTERNAL resource (https://bla.mycomp.nl/docs). Since this resource happens to have the same base url than the site deployment url, maven thinks that it should be treated as relative.
I agree with Ramon, that maven should not override well established conventions here just to correct wrong configuration (people using absolute url's in the site descriptors where they should use relatives).

Also I did not say that the project's main site url should be relative.

What would the configuration option be here? 'interpret ALL absolute url's with the same base-url as the site root as relative url's'  ?

Correct me if I didn't get what you commented.

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=130243#action_130243 ]

Philip May commented on MSITE-159:
----------------------------------

This bug is realy ugly cause this way it's very difficult to have a sourceforge project site build by maven...
With a Sorceforge project you have to link to them...

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=131051#action_131051 ]

Paul Davis commented on MSITE-159:
----------------------------------

Best would be an option to specify. ESPECIALLY for external links.
External links should never get converted to relative links, which appears to happen arbitrarily.

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=141113#action_141113 ]

M. Rohrmoser commented on MSITE-159:
------------------------------------

Workaround: replace one of the characters of the external/absolute URL with it's url-encoded form, e.g. a . (dot) within the servername with %2e.

This seems to prevent substitution.

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

    [ http://jira.codehaus.org/browse/MSITE-159?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=142192#action_142192 ]

M. Rohrmoser commented on MSITE-159:
------------------------------------

Sadly, the workaround above will not work with Firefox 3.0 - see https://bugzilla.mozilla.org/show_bug.cgi?id=43659

> Absolute URI rendered as relative URI if absolute URI related to domain of POM URI
> ----------------------------------------------------------------------------------
>
>                 Key: MSITE-159
>                 URL: http://jira.codehaus.org/browse/MSITE-159
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>          Components: relative links
>            Reporter: Ted Husted
>
> Under site-beta5
> if the POM references a URI like
>   <url>http://struts.apache.org</url>
> absolute URLs used in the site.xml file are converted to relative references.
> For example a reference to to "http://struts.apache.org/1.x" becomes "1.x",  and a reference to
> just "http://struts.apache.org" becomes an empty string.  
> If the documentation is being used offline, there are many cases when we want to refer people back to the website, to be sure the current information is used. The best use case is a download page that determines the mirror via CGI.
> Another use case is referring to a sister site in the domain, that might refer to another version. If used locally, the other site might not be in the relative location.
> Switching back to beta4 cures the behavior, and absolute URIs remain absolute, as expected.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira