Broken link summary include the referencing URLs

• Key: FOR-204
• Type: Improvement
• Status: Closed
• Resolution: Fixed
• Priority: Minor
• Assignee: Unassigned
• Reporter: Lorenz Froihofer
• Component/s: Core operations
• Affects Version/s: 0.6
• Fix Version/s: 0.7

Description

It would be helpful if the brokenlinks.xml file contained for each broken link a summary of files where the broken link occured.

Example: test1.xml, test2.xml and test3.xml have a link to linkeddoc.xml. Now the linkeddoc.xml is moved to another directory but the test?.xml files are not updated. The brokenlinks.xml should contain something like:

<link message="/old-file-path/linkeddoc.xml (No such file or directory)">
  <name>linkdeddoc.html</name>
  <document>/file-path/test1.xml</document>
  <document>/file-path/test2.xml</document>
  <document>/file-path/test3.xml</document>
</link>

Comments

There is some discussion of this in the old email archives. It would be up to the Cocoon CLI to do this. There are various powers of CLI that we are not using.
http://cocoon.apache.org/2.1/userdocs/offline/
http://cocoon.apache.org/2.1/userdocs/offline/configuration.html

[David Crossley]

Added an enhancement request to Cocoon's Bugzilla:
CLI: enhance brokenlinks.xml to also report the referring URLs
http://issues.apache.org/bugzilla/show_bug.cgi?id=31657

[David Crossley]

(Bringing over Rick's comment from the duplicate issue FOR-323.)

In particular, it would aid in identifying problems as found in FOR-321.

[David Crossley]

Upayavira added the ability in Cocoon. Now Forrest uses that and adds the "show-referrers" attribute to the "broken-links" element of the Cocoon cli.xconf configuration.