external xrefs are not linked in HTML

[AmyC]

My project contains 15+ separate XML files (element = chapter), linked together by include statements in a book:
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="File_a.xml"/>

Each of these separate XML files contain xrefs to sections/chapters in other XML files within the project.

When the XML files are transformed to HTML (using the Doc HTML general scenario), xrefs to other files appear as "???" in the HTML files.

Can Oxygen link the xrefs together in these individual files (need to use the individual HTML files for on line help)?

Thanks, Amy

Oxygen v10.2

[sorin_ristache]

Hello,

Yes, if the linkend attribute of xref points to an ID attribute that is defined in an XML file included in the same book document then the HTML result (generated for example with the built-in scenario DocBook HTML applied to the book document) should contain a valid link at the point of the xref element. If that is not true in your case please post small sample files for reproducing the problem of the missing link at the location of the xref reference: a small book example and two small included chapters with one chapter containing an xref that points to an ID of the other chapter.


Regards,
Sorin

[AmyC]

Hi Sorin,

The xrefs work fine in the generated book (containing the include statements). They do not work in the separate XML/HTML files. I'm thinking there's a parameter to tweak in the book to enable Oxygen to display them correctly in the individual files?

Please let me know if you still need examples.

Thanks,

Amy

[sorin_ristache]

The xref references cannot work if you transform only individual files because the target file of the xref reference needs to be processed in the same transformation so that the xref element can be replaced with an HTML a element with a valid href attribute value, that is an attribute value that points to a real anchor in a real target file. You should transform a document that includes both the source file (the file containing the xref element) and the target file.


Regards,
Sorin