[
https://jira.codehaus.org/browse/DOXIA-525?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Aleksey Nesterenko updated DOXIA-525:
--------------------------------------
Description:
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/linkcheck.html
Problems in scope of doxia are in the end of report, e.g.:
apidocs/com/puppycrawl/tools/checkstyle/api/AbstractFileSetCheck.html#processFilteredjava.io.File_java.util.List:
doesn't exist.
For example, rendering link in this velocity template breaks it:
https://github.com/alexkravin/linkstest/blob/master/src/xdocs/writingchecks.xml.vm#L486
brackets and space in the link are broken, the similar problem was specified
here http://osdir.com/ml/issues.maven.apache.org/2013-02/msg00437.html
Steps of reproducing my problem (for simplifying I'm pointing on my test
project):
1) git clone [email protected]:alexkravin/linkstest.git && cd linkstest/
2) mvn clean install site
3) Open target/site/linkcheck.html
Current report: http://alexkravin.github.io/testproject/linkcheck.html
was:
Generating linkcheck report on our project has encountered some problems.
In final report lots of links are marked as "invalid"
I have already opened issue against maven-javadoc-plugin:
http://jira.codehaus.org/browse/MJAVADOC-425
As it is using outdated version of doxia's libs
But in last version of linkcheck-plugin
(I use
<dependency>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-linkcheck-plugin</artifactId>
<version>1.2</version>
</dependency>
8-oct-2014)
Doxia's version is 1.4.
So, I think linkcheck-plugin has to be updated too.
Steps of reproducing my problem:
1) git clone [email protected]:alexkravin/linkstest.git && cd linkstest/
2) mvn clean install site
3) Open target/site/linkcheck.html
Example of my current report:
http://alexkravin.github.io/testproject/linkcheck.html
As you can see - even "invalid" link will redirect you to proper location.
E.g.:
apidocs/com/MyClass.html
error ../com/MyClass.html#MyClass(java.lang.String,%20int): doesn't exist.
but it's valid
http://alexkravin.github.io/testproject/apidocs/com/MyClass.html#MyClass(java.lang.String,%20int)
P.S.
Problems in the end of report are not in scope of this plugin, e.g.:
apidocs/com/puppycrawl/tools/checkstyle/api/Check.html#beginTreecom.puppycrawl.tools.checkstyle.api.DetailAST:
doesn't exist.
brackets in link are broken, that's because of doxia's renderer, see
http://osdir.com/ml/issues.maven.apache.org/2013-02/msg00437.html
> Links to methods are marked as "invalid"
> ----------------------------------------
>
> Key: DOXIA-525
> URL: https://jira.codehaus.org/browse/DOXIA-525
> Project: Maven Doxia
> Issue Type: Bug
> Reporter: Aleksey Nesterenko
>
> 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/linkcheck.html
> Problems in scope of doxia are in the end of report, e.g.:
> apidocs/com/puppycrawl/tools/checkstyle/api/AbstractFileSetCheck.html#processFilteredjava.io.File_java.util.List:
> doesn't exist.
> For example, rendering link in this velocity template breaks it:
> https://github.com/alexkravin/linkstest/blob/master/src/xdocs/writingchecks.xml.vm#L486
> brackets and space in the link are broken, the similar problem was specified
> here http://osdir.com/ml/issues.maven.apache.org/2013-02/msg00437.html
> Steps of reproducing my problem (for simplifying I'm pointing on my test
> project):
> 1) git clone [email protected]:alexkravin/linkstest.git && cd linkstest/
> 2) mvn clean install site
> 3) Open target/site/linkcheck.html
> Current report: http://alexkravin.github.io/testproject/linkcheck.html
--
This message was sent by Atlassian JIRA
(v6.1.6#6162)
