Odd validation messages

Post here questions and problems related to editing and publishing DITA content.
maglid
Posts: 75
Joined: Mon Sep 28, 2009 8:10 am

Odd validation messages

Post by maglid »

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

Code: Select all

<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
Radu
Posts: 9446
Joined: Fri Jul 09, 2004 5:18 pm

Re: Odd validation messages

Post by Radu »

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply