Tsz-Wo Nicholas Sze wrote:
Hi Lukas, Thanks a lot for the reply. So there is no way to do it due to DOXIA-397.
As noted there, a workaround is to use absolute links.
I got a second question: Is it possible to add links in verbatim text? The following does not work.
No, as documented at http://maven.apache.org/doxia/references/apt-format.html:
'Like in HTML, verbatim text is preformatted. Unlike HTML, verbatim text is escaped: inside a verbatim display, markup is not interpreted by the APT processor.'
Cheers, -Lukas
+------------------------------------------------------------------- A link: {{{http://host/foo}foo}} +------------------------------------------------------------------- ~~ BAD: The output is "<pre>A link: {{{http://host/foo}foo}}</pre>". Regards, Nicholas ________________________________ From: Lukas Theussl<[email protected]> To: Maven Users List<[email protected]> Sent: Wednesday, December 7, 2011 11:17 PM Subject: Re: APT: How to add relative links with special symbols? That's a known issue and discussed here: http://jira.codehaus.org/browse/DOXIA-397 HTH, -Lukas Tsz-Wo Nicholas Sze wrote:Hi, I tried to add relative links with special symbols (e.g. '%', ' ', '(') to apt docs. However, the special symbols are removed/replaced in the generated doc and so the link does not work. For examples, * {{{../api/Test.html#foo(int, String)}Unespaced relative url}} ~~ BAD: It becomes<a href="../api/Test.html#fooint_String">Unespaced relative url</a> * {{{../api/Test.html#foo%28int,%20String%29}Espaced relative url}} ~~ BAD: It becomes<a href="../api/Test.html#foo28int20String29">Espaced relative url</a> I notice that it works for absolute links. * {{{http://host/api/Test.html#foo(int, String)}Unespaced absolute url}} ~~ GOOD: It becomes<a class="externalLink" href="http://host/api/Test.html#foo(int, String)">Unespaced absolute url</a> * {{{http://host/api/Test.html#foo%28int,%20String%29}Espaced absolute url}} ~~ GOOD: It becomes<a class="externalLink" href="http://host/api/Test.html#foo%28int,%20String%29";>Espaced absolute url</a> I apologize if this is not the correct emailing list for the question. Regards, Nicholas --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]--------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
--------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
