You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "SebbASF (JIRA)" <ji...@codehaus.org> on 2012/10/23 12:14:36 UTC

[jira] (MSITE-660) CLONE - Brackets not working when generating links using site plugin

SebbASF created MSITE-660:
-----------------------------

             Summary: CLONE - Brackets not working when generating links using site plugin
                 Key: MSITE-660
                 URL: https://jira.codehaus.org/browse/MSITE-660
             Project: Maven 2.x and 3.x Site Plugin
          Issue Type: Bug
         Environment: MacOSX Lion 64 bit

java version "1.6.0_33"
Java(TM) SE Runtime Environment (build 1.6.0_33-b03-424-11M3720)
Java HotSpot(TM) 64-Bit Server VM (build 20.8-b03-424, mixed mode)

Apache Maven 3.0.3 (r1075438; 2011-02-28 09:31:09-0800)
Maven home: /usr/share/java/maven-3.0.3
Java version: 1.6.0_33, vendor: Apple Inc.
Java home: /System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home
Default locale: en_US, platform encoding: MacRoman
OS name: "mac os x", version: "10.7.4", arch: "x86_64", family: "mac"

            Reporter: SebbASF


This was discovered together with Simone Tripodi when dealing with the Apache Commons Functor project (http://commons.apache.org/functor/): I've put together the attached file which include some links to the javadoc section of the site (generated using maven site plugin). 
Some links are links to the classes/interfaces or packages -- and these work. Example:
{code:xml}
 <a href="apidocs/org/apache/commons/functor/aggregator/ArrayListBackedAggregator.html">ArrayListBackedAggregator</a>
{code}

However, where the link is meant to be a link to the method javadoc directly, and as such it includes brackets, the brackets are lost it the process of generating the html. Example:

{code:xml}
<a href="apidocs/org/apache/commons/functor/aggregator/AbstractListBackedAggregator.html#createList()">createList()</a>
{code}

generates (you can see this on the live site here http://commons.apache.org/functor/aggregator.html):

{code:xml}
<a href="apidocs/org/apache/commons/functor/aggregator/AbstractListBackedAggregator.html#createList">createList()</a>
{code}

Same happens if the method has parameters:

{code:xml}
<a href="apidocs/org/apache/commons/functor/aggregator/Aggregator.html#add(T)">add()</a>
{code}

generates 

{code:xml}
<a href="apidocs/org/apache/commons/functor/aggregator/Aggregator.html#addT">add()</a>
{code}

I am attaching the original xml file to this. I use a Mac but I believe Simo uses a Linux -- so it's not something to do with encoding I don't think. (As a side note we have actually changed various encoding settings to get the same result.)

Please let me know if there is anything else we need to provide you with.
Kind regards,

Liv

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://jira.codehaus.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] (MSITE-660) CLONE - Brackets not working when generating links using site plugin

Posted by "SebbASF (JIRA)" <ji...@codehaus.org>.
    [ https://jira.codehaus.org/browse/MSITE-660?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=312027#comment-312027 ] 

SebbASF commented on MSITE-660:
-------------------------------

See original issue:

bq. As per Lukas's comment, need to escape the # so this is not a bug.

That does *not* solve the issue: if the # is encoded, then the displayed URL is OK, but the URL no longer works.

This is because the # is no longer present in the URL.
That's the main point of encoding characters in URLs - to stop them being interpreted as meta-characters.
The link will only work properly if the generated URL contains the #
                
> CLONE - Brackets not working when generating links using site plugin
> --------------------------------------------------------------------
>
>                 Key: MSITE-660
>                 URL: https://jira.codehaus.org/browse/MSITE-660
>             Project: Maven 2.x and 3.x Site Plugin
>          Issue Type: Bug
>         Environment: MacOSX Lion 64 bit
> java version "1.6.0_33"
> Java(TM) SE Runtime Environment (build 1.6.0_33-b03-424-11M3720)
> Java HotSpot(TM) 64-Bit Server VM (build 20.8-b03-424, mixed mode)
> Apache Maven 3.0.3 (r1075438; 2011-02-28 09:31:09-0800)
> Maven home: /usr/share/java/maven-3.0.3
> Java version: 1.6.0_33, vendor: Apple Inc.
> Java home: /System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home
> Default locale: en_US, platform encoding: MacRoman
> OS name: "mac os x", version: "10.7.4", arch: "x86_64", family: "mac"
>            Reporter: SebbASF
>
> This was discovered together with Simone Tripodi when dealing with the Apache Commons Functor project (http://commons.apache.org/functor/): I've put together the attached file which include some links to the javadoc section of the site (generated using maven site plugin). 
> Some links are links to the classes/interfaces or packages -- and these work. Example:
> {code:xml}
>  <a href="apidocs/org/apache/commons/functor/aggregator/ArrayListBackedAggregator.html">ArrayListBackedAggregator</a>
> {code}
> However, where the link is meant to be a link to the method javadoc directly, and as such it includes brackets, the brackets are lost it the process of generating the html. Example:
> {code:xml}
> <a href="apidocs/org/apache/commons/functor/aggregator/AbstractListBackedAggregator.html#createList()">createList()</a>
> {code}
> generates (you can see this on the live site here http://commons.apache.org/functor/aggregator.html):
> {code:xml}
> <a href="apidocs/org/apache/commons/functor/aggregator/AbstractListBackedAggregator.html#createList">createList()</a>
> {code}
> Same happens if the method has parameters:
> {code:xml}
> <a href="apidocs/org/apache/commons/functor/aggregator/Aggregator.html#add(T)">add()</a>
> {code}
> generates 
> {code:xml}
> <a href="apidocs/org/apache/commons/functor/aggregator/Aggregator.html#addT">add()</a>
> {code}
> I am attaching the original xml file to this. I use a Mac but I believe Simo uses a Linux -- so it's not something to do with encoding I don't think. (As a side note we have actually changed various encoding settings to get the same result.)
> Please let me know if there is anything else we need to provide you with.
> Kind regards,
> Liv

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://jira.codehaus.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira