Page 1 of 1

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

Posted: Fri Nov 11, 2022 5:47 am
by 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

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

image.png

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

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

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

Posted: Fri Nov 11, 2022 12:38 pm
by adrian_sorop
Hi,
The internal issue id is: EXM-51845
Thanks,
Adrian S.

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

Posted: Fri Nov 11, 2022 2:26 pm
by chrispitude
Thanks Adrian!

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

image.png

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