Reply To: xref Links to same file break in PDF

[Derek Read]

There is no requirement to include the filename in the @href.

and this should be equivalent when the xref and what it is linking to are both inside the file filename.dita and the DITA OT treats handles this just fine (at least in my tests).

The behavior of the DITA OT follows what the DITA 1.1 Language Reference says (my highlighting in blue) for the usage of the href attribute:
[quote=http://docs.oasis-open.org/dita/v1.1/CS01/langspec/langref/xref.html#xref__xref_attr]A hyperlink to an external Web page (URL) or other non-DITA resource, to another DITA topic in the same file or in another file, or to a specific element inside a DITA topic . . . DITA content is targetted as follows:
Target elsewhere in the same file:
  href=”#topicID”
  href=”#topicID/elemID
Target in a different file:
  href=”filename.dita#topicID”
  href=”fname.dita#topicID/elemID”
. . .

Having said that, XMetaL Author Enterprise will include the filename when you use the Insert Cross Reference dialog. The DITA OT has no problem handling either and the XMetaL Author Enterprise link checking functionality also handles both methods (when you have broken links you have the option to view a dialog named “Unresolved References Log”).

Reply