[ https://issues.apache.org/jira/browse/DOXIA-525?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Robert Scholte closed DOXIA-525. -------------------------------- Resolution: Invalid Assignee: Robert Scholte Velocity has some known parsing issues. We can't upgrade to a newer version because it breaks a couple of our tests, which seems to be regression in Velocity. But your issue can be solved by using [$\{esc.hash}|https://velocity.apache.org/tools/devel/generic/EscapeTool.html#getHash()] or [$\{esc.h}|https://velocity.apache.org/tools/devel/generic/EscapeTool.html#getH()] > Rendering links in xdocs breaks them > ------------------------------------ > > Key: DOXIA-525 > URL: https://issues.apache.org/jira/browse/DOXIA-525 > Project: Maven Doxia > Issue Type: Bug > Components: Module - Xdoc > Affects Versions: 1.6 > Reporter: Aleksey Nesterenko > Assignee: Robert Scholte > > Generating linkcheck report on our project has encountered some problems. > In final report lots of links are marked as "invalid" > Report generated on test project: > http://alexkravin.github.io/testproject/writingchecks.html > For example try to follow link processFiltered(java.io.File, java.util.List) > Look to the URL: > link looks like > AbstractFileSetCheck.html#processFilteredjava.io.File_java.util.List > Rendering link in this velocity template breaks it: > https://github.com/alexkravin/linkstest/blob/master/src/xdocs/writingchecks.xml.vm#L13 > brackets and space in the link are broken, the similar problem was specified > here > DOXIA-397 > but in velocity template developer can't put '##' - it would fail the > rendering with an error: > {noformat} > [ERROR] Error parsing /home/asus/sources/links/src/xdocs/writingchecks.xml.vm > as a velocity template, using as text. > {noformat} > Steps of reproducing my problem (for simplifying I'm pointing on my test > project): > # git clone g...@github.com:alexkravin/linkstest.git && cd linkstest/ > # mvn clean site > # Open target/site/writingchecks.html -- This message was sent by Atlassian JIRA (v6.3.4#6332)