In editor, notify writer of empty cross-book (peer map) link elements

[chrispitude]

In a map with the following peer map reference:

Code: Select all

<mapref href="peer_map.ditamap" keyscope="peer_map" processing-role="resource-only" scope="peer"/>

let's say I have a topic with a variable reference and topic reference into the peer map:

Code: Select all

<p>Reference to peer map variable: <ph keyref="peer_map.peer_variable"/></p>
<p>Reference to peer map topic: <xref keyref="peer_map.peer_map_topic"/></p>

The Oxygen v25 editor shows the following:

image.png (13.34 KiB) Viewed 545 times

and the content publishes (to any format) as follows:

image.png (6.05 KiB) Viewed 545 times

The editor warned us that the peer map variable would not resolve, but it did not warn us that the peer map cross-reference target text would not resolve.

It would be useful if the Oxygen editor can have some kind of indication for the writer that explicit target text is needed inside an empty <xref> or <link> into a peer map. If the element contains target text, then the indication is not needed.

Testcase:

oxygen_peer_map_xrefs.zip

(2.54 KiB) Downloaded 78 times

Please let us know the issue ID for this enhancement request so we can track it on our side. Thanks!

[adrian_sorop]

Hi,
The internal issue id is: EXM-51845
Thanks,
Adrian S.

[chrispitude]

Thanks Adrian!

The peer map variable check is implemented in both the editor and in Validate and Check for Completeness:

image.png (12.93 KiB) Viewed 525 times

So it would be good if this new cross-reference check could behave consistently.