Oxygen XML Forum

Posted: **Fri Mar 03, 2017 9:13 am**

Using version 18.1.
My map called top-level.ditamap references topics and a map of key definitions:

<map>

 <title>My Guide</title> 

 <topicref href="topic1.xml" />

 <topicref href="topic2.xml" />

 <mapref href="keydefs.ditamap" format="ditamap"/>

</map>

keydefs.ditamap is like a variable file with thousands of keydefs like this:

Code: Select all

<keydef href="incompatible_changes.xml" keys="incompatible_changes"/>

These keys are referred to in the topics like this:

See <xref keyref="incompatible_changes"/> for the procedure...

When I use Oxygen to validate top-level.ditamap, I get thousands of notices like this one:

Code: Select all

Reference  W [REF] Topic "impala_incompatible_changes.xml" is referenced in the DITA map as "resource-only". Any cross reference to it will result in a broken link.

Can I turn off these warnings? Or is there some legitimate error that I am missing?

Thanks,
Mark

Posted: **Fri Mar 03, 2017 9:56 am**

Hi Mark,

Once a topic is referenced as resource-only in the DITA Map it will no longer be present in the PDF output. So as a result all links to it will be broken.
This is why we report the problem and right now we do not have a setting to control this.
Usually resource-only topics should only be used for content references, links should always be made to topics which are referenced with normal processing somewhere in the DITA Map.

Regards,
Radu

Oxygen XML Forum

Odd validation messages

Odd validation messages

Re: Odd validation messages