[ 
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

        

Reply via email to