Xref placeholder issue when referencing list item inside a DITA topic

Having trouble deploying Oxygen XML Web Author? Got a bug to report? Post it all here.
Jean-Gabriel
Posts: 1
Joined: Thu May 21, 2026 11:08 am

Xref placeholder issue when referencing list item inside a DITA topic

Post by Jean-Gabriel »

Hi
I have an issue when using xref referencing list item or steps in the same Dita topic. There is a cache keeping the numbering of the list and I want to clear this cache in order to have the placeholder content of my xref change if the list item is moved from position 1 to position 2 for example. The placeholder remains "1." when I expect it to be changed to "2."

I found a clearReferencesCache in the DitaLinkResolver but I don't know how to call it properly.

Thanks,
Jean-Gabriel
cosminef
Site Admin
Posts: 292
Joined: Wed Aug 30, 2023 2:33 pm

Re: Xref placeholder issue when referencing list item inside a DITA topic

Post by cosminef »

Hello,

Thank you for reaching out.

There is an API that notifies you whenever changes are made to a document. You can use it to determine when the xref changes, in which case the cache should no longer be used.
The API is "AuthorListener" (there is also AuthorListenerAdapter) https://www.oxygenxml.com/InstData/Edit ... tener.html
and it can be registered using "addAuthorListener" https://www.oxygenxml.com/InstData/Edit ... rListener)

Best,
Cosmin
Cosmin Eftenie
www.oxygenxml.com
Post Reply