Page 1 of 1

oxygen feature "Remove Reference(s)"

Posted: Wed Dec 18, 2024 12:12 pm
by vishwavaranasi
Hello Team , we need some help with the oxygen feature "Remove Reference(s)"
image.png
lets say am working with a Bookmap (GUID-BOOKMAP),which contains several topics
Topic 1 (GUID1) has a conkeyref to Topic 6 (GUID6): <p conkeyref="GUID6/id">
Topic 2 (GUID2) has an xref to Topic 6 (GUID6): <xref href="GUID6">
Topic 3 (GUID3) has no references.
Topic 4 (GUID4) has an xref to Topic 6 (GUID6): <xref href="GUID6">
Topic 5 (GUID5) has no references.
Topic 6 (GUID6) is the target topic that others are referencing.

What we are doing here :
Removing the Reference to Topic 6 The operation being performed in the OxygenXML editor is to remove the reference to Topic 6 from the root map (GUID-BOOKMAP).

What we are expecting , is there any settings or API that can do the following To fully remove Topic 6,
Remove the conkeyref from Topic 1.
Remove the xref from Topic 2 and Topic 4.
would you please let us know is this achievable or not?

Thanks,
vishwa

Re: oxygen feature "Remove Reference(s)"

Posted: Wed Dec 18, 2024 2:33 pm
by Radu
Hi,
Oxygen does not know your intended purpose for using the "Remove Reference(s)" action, you may want to refer to the topic some place else or the topic may already be referenced in multiple parts of the DITA Map.
We have a "Delete" action available in the DITA Maps Manager contextual menu which attempts to locate all possible links to the topic. Again even here we do not perform automatically the deletion of all references to the topic. Removing an embedded link from a paragraph may render the entire paragraph useless or without making sense. We rely on the users manually making the relevant changes in all places where the topic is referenced and the relevant changes as I said may be more than just deleting links, they may need to re-write content as well.

Regards,
Radu