xref, conref validation issue

Post here questions and problems related to editing and publishing DITA content.
gszabo
Posts: 13
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
(5.59 KiB) Downloaded 18 times
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
(27.25 KiB) Downloaded 19 times
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: 13
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