Validate sibling ditamap

Posts: 64

Validate sibling ditamap

Tue Sep 19, 2017 3:04 am

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

A folder
      files for A
B folder
      files for B
C folder
      files for C
Posts: 5811

Re: Validate sibling ditamap

Tue Sep 19, 2017 7:59 am

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.

Radu Coravu
<oXygen/> XML Editor
Posts: 64

Re: Validate sibling ditamap

Tue Sep 19, 2017 5:30 pm

Thanks Radu.

Return to “DITA (Editing and Publishing DITA Content)”

Who is online

Users browsing this forum: No registered users and 1 guest