Page 1 of 1

xref, conref validation issue

Posted: Tue Aug 13, 2024 4:23 pm
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

Re: xref, conref validation issue

Posted: Wed Aug 14, 2024 3:31 pm
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.

Re: xref, conref validation issue

Posted: Wed Aug 14, 2024 5:08 pm
by gszabo
Adrian, than you, that solved the issue.

Regards,
George