The order of relationship table items in PDF does not match that in DITAMAP

[longyf_sz]

Hi,
In the relationship table of a DITAMAP, I added:

Code: Select all

<reltable>
        <relheader>
            <relcolspec linking="sourceonly"/>
            <relcolspec linking="targetonly"/>
        </relheader>
        <relrow>
            <relcell>
                <topicref href="Concepts/TopicA.dita"/>
            </relcell>
            <relcell>
                <topicref href="Concepts/Topic1.dita"/>
                <topicref href="Concepts/Topic2.dita"/>
                <topicref href="Reference/Topic3.dita"/>
            </relcell>
        </relrow>
<reltable>

I expect that in the PDF file, at the end of TopicA, there are three "For more information" items, in the order of Topic1, Topic2, and Topic3.

However, in the PDF file, I got the following output at the end of TopicA:
For more information

• Topic3

• Topic1

• Topic2

The order of relationship table items in PDF does not match that in DITAMAP. I am using XML Author 21.1.
Could you please help check the problem? Thank you!

Regards,
Yifei

[julien_lacour]

Hello Yifei,

Oxygen XML Author 21.1 has reached its End of Support period and technical support is no more available.

However I tried using <oXygen/> XML Editor 26.1, build 2024073008 and cannot reproduce the problem, I got the following content in my PDF:
Related information
Topic 1 (on page 4)
Topic 2 (on page 5)
Topic 3 (on page 6)

I suppose the problem occurs because all topics aren't the same type: one is Reference and two are Concepts (based on their hrefs).
If you upgrade to the latest version you will get the correct output and all the new features available.

Regards,
Julien

[longyf_sz]

Hi Julien,
Thanks for your quick reply. Yes, you are right. I tested using the same type of DITA files and the order of relationship table items is correct in PDF.
Before my team upgrade to Oxygen 26.1, may I know if there is any priority for DITA file types? For example, in a PDF file, Reference file links appear first, then Task file links, and finally Concept file links.
Thank you!
Yifei

[julien_lacour]

Hi Yifei,

In Oxygen 26.1 the order should be the following:
- Related concepts
- Related tasks
- Related reference
- Related information

I also mention that you can set the 'args.rellinks.group.mode' parameter in the DITA Map PDF - based on HTML5 & CSS scenario if you want the related links to be displayed as above or all below Related information.

Regards,
Julien

[longyf_sz]

Hi Julien,

I will try this parameter when I get Oxygen 26. Thank you!

Yifei

[longyf_sz]

Hi Julien,

I've upgraded to Oxygen 26.1 and I am revisiting this problem.
When I set the "args.rellinks.group.mode" parameter in the transformation scenario to "single-group", in the PDF file, the reltable links are displayed in the following order:
- Related references
- Related concepts and tasks that match their relative order in the reltable
However, the first link in the reltable is a concept DITA file, not a reference DITA file. In the PDF file, I want that concept DITA file to be displayed as the first link also. Now, a reference DITA file is displayed as the first link in the PDF file. The order of links in the PDF file does not match the order of links in the reltable.
Could you please help check if there is any method to make the order of links in the PDF file exactly match the order of links in the reltable?
Thank you!

Regards,
Yi-Fei