Re: [oXygen-user] [OXYGEN-13700] cross references in reusable content
Hello Judith, An internal link inside a reused component should look like this:
<div id="reusable"> <table id="myTable"> <tgroup cols="1"> <tbody> <row> <entry></entry> </row> </tbody> </tgroup> </table> <p> Paragraph <xref href="#./myTable"/> </p> </div> So:
<xref href="#./myTable"/> That "#." part is called a self link, there are some examples of it here:
https://www.oxygenxml.com/dita/1.3/specs/langRef/base/xref.html So the "<xref href="#./myTable"/>" should properly resolve in the HTML/PDF no matter where the entire reusable component will be used. But this depends also on the publishing offered by Ixiasoft which we do not control. About how you can insert "<xref href="#./myTable"/>" constructs, Ixiasoft in general allows only inserting keyref links but in this case such a relative href link would need to be inserted in order for the link to work. If Ixiasoft's Oxygen integration does not offer you the way to insert such a link in the Author page, you can try to insert it in the Text editing mode and ask Ixiasoft to take such an use case into account for a future version. About this remark:
Do you offer DITA or Oxygen courses for technical authors who would like to learn a bit more about how these kind of things work? We do not offer training/courses. Even if we would, it would not help you much because you are using Oxygen with Ixiasoft which controls what actions and functionality the editor offers, the workflows are controlled by the CMS.
The DITA 1.3 specification is quite an useful set of resources about what the DITA standard can and cannot do. We also have a set of videos for learning DITA with Oxygen (but they are with Oxygen desktop which has more functionality than the Oxygen products which are embedded and customized by Ixiasoft): https://blog.oxygenxml.com/topics/learnDita.html Hope this helps! Regards, Radu Radu Coravu Oxygen XML Editor On 3/12/24 10:26, Oudkerk, Judith wrote:
Hi All,
A colleague of mine would like to use cross references within reusable content. For example, he created a reusable content topic with <p> elements and <table> elements. In the <p> elements, he created an <xref> to the <table> element, but in the PDF, this does not result in a correct link. Is there a way to incorporate <xref> elements in reusable content? I would think it’s possible with conkeyrefs, but I can’t figure out how to implement this. Any suggestion would be appreciated.
We work with Oxygen embedded in Ixiasoft Eclipse / Madcap IXIA CCMS Web.
Thank you.
Kind regards,
Judith
PS. Do you offer DITA or Oxygen courses for technical authors who would like to learn a bit more about how these kind of things work?
Restricted Information and Basic Personal Data
Judith Oudkerk
|
Technical Writer
ELEKTA | Nucletron
P.O. Box 930,
3900 AX,
Veenendaal,
The Netherlands
Visiting Address:
Waardgelder 1, 3905 TH Veenendaal
Judith.Oudkerk@elekta.com
|
www.elekta.com <https://www.elekta.com/>
Nucletron B.V., registered 2730 3235 Nucletron Operations B.V., registered 30129540
This message is confidential and may be legally privileged or otherwise protected from disclosure. If you are not the intended recipient, please telephone or email the sender and delete this message and any attachment from your system; you must not copy or disclose the contents of this message or any attachment to any other person. Any views expressed in this message are those of the individual sender, except where the sender specifies and with authority, states them to be the views of Elekta. Elekta may monitor email traffic data.
Restricted Information and Basic Personal Data
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
Hi Radu, Thanks for your quick and extensive reply. Unfortunately, the trick doesn’t work in our Eclipse/CMS web environment ☹. It did work in my Oxygen stand alone version, so I did something right… Kind regards, Judith Judith Oudkerk | Technical Writer ELEKTA | Nucletron P.O. Box 930, 3900 AX, Veenendaal, The Netherlands Visiting Address: Waardgelder 1, 3905 TH Veenendaal Judith.Oudkerk@elekta.com<mailto:Judith.Oudkerk@elekta.com> | www.elekta.com<https://www.elekta.com/> Nucletron B.V., registered 2730 3235 Nucletron Operations B.V., registered 30129540 [cid:image978017.png@837EAD10.69DE3B14] This message is confidential and may be legally privileged or otherwise protected from disclosure. If you are not the intended recipient, please telephone or email the sender and delete this message and any attachment from your system; you must not copy or disclose the contents of this message or any attachment to any other person. Any views expressed in this message are those of the individual sender, except where the sender specifies and with authority, states them to be the views of Elekta. Elekta may monitor email traffic data. Restricted Information and Basic Personal Data From: oXygen-user <oxygen-user-bounces@oxygenxml.com> On Behalf Of Oxygen XML Editor Support (Radu Coravu) Sent: Tuesday, March 12, 2024 9:59 AM To: oxygen-user@oxygenxml.com Subject: Re: [oXygen-user] [OXYGEN-13700] cross references in reusable content Hello Judith, An internal link inside a reused component should look like this: <div id="reusable"> <table id="myTable"> <tgroup cols="1"> <tbody> <row> <entry></entry> </row> </tbody> </tgroup> </table> <p> Paragraph <xref href="#./myTable"/> </p> </div> So: <xref href="#./myTable"/> That "#." part is called a self link, there are some examples of it here: https://www.oxygenxml.com/dita/1.3/specs/langRef/base/xref.html<https://www.oxygenxml.com/dita/1.3/specs/langRef/base/xref.html> So the "<xref href="#./myTable"/>" should properly resolve in the HTML/PDF no matter where the entire reusable component will be used. But this depends also on the publishing offered by Ixiasoft which we do not control. About how you can insert "<xref href="#./myTable"/>" constructs, Ixiasoft in general allows only inserting keyref links but in this case such a relative href link would need to be inserted in order for the link to work. If Ixiasoft's Oxygen integration does not offer you the way to insert such a link in the Author page, you can try to insert it in the Text editing mode and ask Ixiasoft to take such an use case into account for a future version. About this remark: Do you offer DITA or Oxygen courses for technical authors who would like to learn a bit more about how these kind of things work? We do not offer training/courses. Even if we would, it would not help you much because you are using Oxygen with Ixiasoft which controls what actions and functionality the editor offers, the workflows are controlled by the CMS. The DITA 1.3 specification is quite an useful set of resources about what the DITA standard can and cannot do. We also have a set of videos for learning DITA with Oxygen (but they are with Oxygen desktop which has more functionality than the Oxygen products which are embedded and customized by Ixiasoft): https://blog.oxygenxml.com/topics/learnDita.html<https://blog.oxygenxml.com/topics/learnDita.html> Hope this helps! Regards, Radu Radu Coravu Oxygen XML Editor Restricted Information and Basic Personal Data On 3/12/24 10:26, Oudkerk, Judith wrote: Hi All, A colleague of mine would like to use cross references within reusable content. For example, he created a reusable content topic with <p> elements and <table> elements. In the <p> elements, he created an <xref> to the <table> element, but in the PDF, this does not result in a correct link. Is there a way to incorporate <xref> elements in reusable content? I would think it’s possible with conkeyrefs, but I can’t figure out how to implement this. Any suggestion would be appreciated. We work with Oxygen embedded in Ixiasoft Eclipse / Madcap IXIA CCMS Web. Thank you. Kind regards, Judith PS. Do you offer DITA or Oxygen courses for technical authors who would like to learn a bit more about how these kind of things work? Restricted Information and Basic Personal Data Judith Oudkerk | Technical Writer ELEKTA | Nucletron P.O. Box 930, 3900 AX, Veenendaal, The Netherlands Visiting Address: Waardgelder 1, 3905 TH Veenendaal Judith.Oudkerk@elekta.com<mailto:Judith.Oudkerk@elekta.com> | www.elekta.com<https://www.elekta.com/> Nucletron B.V., registered 2730 3235 Nucletron Operations B.V., registered 30129540 [cid:image001.png@01DA7523.ABA2A880] This message is confidential and may be legally privileged or otherwise protected from disclosure. If you are not the intended recipient, please telephone or email the sender and delete this message and any attachment from your system; you must not copy or disclose the contents of this message or any attachment to any other person. Any views expressed in this message are those of the individual sender, except where the sender specifies and with authority, states them to be the views of Elekta. Elekta may monitor email traffic data. Restricted Information and Basic Personal Data _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com<mailto:oXygen-user@oxygenxml.com> https://www.oxygenxml.com/mailman/listinfo/oxygen-user<https://www.oxygenxml.com/mailman/listinfo/oxygen-user>
participants (2)
-
Oudkerk, Judith -
Oxygen XML Editor Support (Radu Coravu)