Page 1 of 1

Validate sibling ditamap

Posted: Tue Sep 19, 2017 3:04 am
by pault
Here's the context for my question: Rather than creating external links from each book to other books within our doc set, we generate a master.ditamap file that contains all the keyrefs for every book. In turn, we have a process that looks at the keyrefs in each book and generates an internal or external link as required when generating HTML using Oxygen Webhelp. The process itself works great and saves a lot of time, effort, and link fixing.

The problem is that when using the DITA Map Completeness Check, it shows these (external) keyrefs as broken, even though the Root map is set to the master.ditamap. Is there something I can do so that only truly broken keyrefs are displayed?

Here's the basic structure:

Code: Select all

masterKeydefs.ditamap
A.ditamap
A folder
files for A
B.ditamap
B folder
files for B
C.ditamap
C folder
files for C
...

Re: Validate sibling ditamap

Posted: Tue Sep 19, 2017 7:59 am
by Radu
Hi Paul,

Right now the "Validate and check for completeness" action does not take the root map information into account, it considers as the main DITA Map the current DITA Map selected in the tabbed pane.
The current behavior may sometimes be useful, for example you may want to check that an opened submap is truly self contained.
But I also understand your use case, we already have an opened internal issue to take the root map into account so I will add your vote for it there.
Maybe in a future version we could add an extra check box in the list of validate and check for completeness settings to control this behavior.
We will update this forum thread when we manage to make a fix for this.

Regards,
Radu

Re: Validate sibling ditamap

Posted: Tue Sep 19, 2017 5:30 pm
by pault
Thanks Radu.