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

Wed Mar 13 02:55:25 CDT 2024

Hi Judith,

With pleasure, maybe you can start a discussion with the Ixiasoft side 
about this.

Regards,

Radu

Radu Coravu
Oxygen XML Editor

On 3/13/24 09:51, Oudkerk, Judith wrote:
> 
>
> 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 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
>
> From:* oXygen-user <oxygen-user-bounces at oxygenxml.com> *On Behalf Of 
> *Oxygen XML Editor Support (Radu Coravu)
> *Sent:* Tuesday, March 12, 2024 9:59 AM
> *To:* oxygen-user at 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
>
> 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
>
>
> 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 at elekta.com <mailto: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
>
>
> _______________________________________________
> 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/20240313/1de6ed74/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image978017.png
Type: image/png
Size: 16895 bytes
Desc: not available
URL: <http://www.oxygenxml.com/pipermail/oxygen-user/attachments/20240313/1de6ed74/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.png
Type: image/png
Size: 16895 bytes
Desc: not available
URL: <http://www.oxygenxml.com/pipermail/oxygen-user/attachments/20240313/1de6ed74/attachment-0003.png>