[oXygen-user] [OXYGEN-13700] cross references in reusable content

[Oxygen XML Editor Support (Radu Coravu)]

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 at 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 at oxygenxml.com
> https://www.oxygenxml.com/mailman/listinfo/oxygen-user
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.oxygenxml.com/pipermail/oxygen-user/attachments/20240312/25ab739c/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image828207.png
Type: image/png
Size: 16895 bytes
Desc: not available
URL: <http://www.oxygenxml.com/pipermail/oxygen-user/attachments/20240312/25ab739c/attachment-0001.png>