xref, conref validation issue

Post here questions and problems related to editing and publishing DITA content.
gszabo
Posts: 17
Joined: Wed Jan 25, 2023 1:15 am

xref, conref validation issue

Post by gszabo »

Hello,

I have some topics that include conrefs to topics with xrefs that include key references to target topics. When I validate with Oxygen's validation in DITA Map Manager, the following errors occur:

Topic "<filename>" is referenced in the DITA map as "resource-only". Any cross reference to it will result in a broken link.

However, these topics are not referenced as resource-only. The only resource-only references are in maps that defines keys. So, why do these errors occur?
xref_key_issue.zip
The attached xref_key_issue.zip illustrates the issue. Here are details:
  • The bookmap in the AC_F5-DE sub-directory is used to validate
  • The bookmap references the AC_F5-DE/parameters/m_InterlockBraking-ApplicationSetup.dita and AC_F5-DE/parameters/m_FineTuning-Response-SpeedMode.dita topics, but not as resource-only
  • The bookmap also references a submap in the general-fos/parameters sub-directory, menus_keys.ditamap, that defines the fine_tuning_menu-speed-mode key.
  • The key points to the m_FineTuning-Response-SpeedMode.dita topic in general-fos/parameters
  • The key is referenced in the xref in general-fos/parameters/m_InterlockBraking-ApplicationSetup.dita
Note that the goal is to define the keys in general-fos/parameters/menus_keys.ditamap so that the keys are defined once and they referenced in n number of bookmaps, similarly to this simple example. (The filenames in the general-fos/parameters and AC_F5-DE/parameters are identical because the goal is to have publications include the links

The attached doctypes.zip includes the DTDs used for validation
doctypes.zip
You do not have the required permissions to view the files attached to this post.
adrian_sorop
Posts: 78
Joined: Wed Jun 22, 2016 2:48 pm

Re: xref, conref validation issue

Post by adrian_sorop »

Hi,
The fine_tuning_menu-speed-mode keydef does not specify the processing-role attribute, so the default (resource-only) is used
https://docs.oasis-open.org/dita/dita/v ... eydef.html
Setting the processing-role with other value than resource-only should fix the issue.

Regards,
Adrian S.
Adrian Sorop
<oXygen/> XML Editor
http://www.oxygenxml.com
gszabo
Posts: 17
Joined: Wed Jan 25, 2023 1:15 am

Re: xref, conref validation issue

Post by gszabo »

Adrian, than you, that solved the issue.

Regards,
George
Post Reply