Issue with keyrefs links not showing topic title in webhelp output
Posted: Tue Aug 01, 2023 7:33 pm
Hello everybody,
We have an issue with some cross-references that do not render correctly in the WebHelp output, I was hoping that someone could help.
When publishing, the title of the referenced topic is not displayed: it shows only the name of the html file that is referenced.
Here are two examples of the html source code of the output:
Not ok:
Ok:
In DITA, both are referenced the same way, as
Keys are also correctly applied to both topics in the map.
As you can see, sometimes it writes the file name, and sometimes the correct title…
We use keyrefs, the keys being on the topics at the map level (topicref)
We have tried using href, result is the same.
The bug can appear on any type of topic that is referenced or is doing the reference.
The completeness check did not show any big errors, only unreferenced reusable elements or keys, but the topics having these elements do not always correspond to the ones having the issue.
In a topic, whether all are correctly displayed or whether none.
Sometimes, it looks like some references have an impact on all the other references in a topic. For example, I tried copy-pasting one reference that did not rendered well in one topic, to a topic whose references were OK. All references in the second topics became faulty. But it seems quite unpredictable, and it's difficult to identify them one by one, since the completeness check does not point them.
I hope I was clear enough, and I apologize if not. As I said it's quite unpredictable, I did not manage to identify a regular pattern in this bug... It impacts a lot of topics.
The software version is: Oxygen Author 25.1, build 2023031510
Thank you in advance,
We have an issue with some cross-references that do not render correctly in the WebHelp output, I was hoping that someone could help.
When publishing, the title of the referenced topic is not displayed: it shows only the name of the html file that is referenced.
Here are two examples of the html source code of the output:
Not ok:
Code: Select all
You need to perform <a class="- topic/xref xref" href="t-ChangingCustomerOrderStatus.html">t-ChangingCustomerOrderStatus.html</a>.Code: Select all
You can perform <a class="- topic/xref xref" href="t-ApprovingInvoice.html">Approving the Invoice</a>.Code: Select all
You need to perform <xref keyref="change.customer.order.status"/>.Code: Select all
You can perform <xref keyref="approve.invoice"/>.As you can see, sometimes it writes the file name, and sometimes the correct title…
We use keyrefs, the keys being on the topics at the map level (topicref)
We have tried using href, result is the same.
The bug can appear on any type of topic that is referenced or is doing the reference.
The completeness check did not show any big errors, only unreferenced reusable elements or keys, but the topics having these elements do not always correspond to the ones having the issue.
In a topic, whether all are correctly displayed or whether none.
Sometimes, it looks like some references have an impact on all the other references in a topic. For example, I tried copy-pasting one reference that did not rendered well in one topic, to a topic whose references were OK. All references in the second topics became faulty. But it seems quite unpredictable, and it's difficult to identify them one by one, since the completeness check does not point them.
I hope I was clear enough, and I apologize if not. As I said it's quite unpredictable, I did not manage to identify a regular pattern in this bug... It impacts a lot of topics.
The software version is: Oxygen Author 25.1, build 2023031510
Thank you in advance,