- oXygen-user - www.oxygenxml.com

Re: [oXygen-user] [OXYGEN-13700] cross references in reusable content
by Oxygen XML Editor Support (Radu Coravu) 13 Mar '24

13 Mar '24

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(a)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(a)oxygenxml.com> *On Behalf Of > *Oxygen XML Editor Support (Radu Coravu) > *Sent:* Tuesday, March 12, 2024 9:59 AM > *To:* oxygen-user(a)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(a)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 > > > > 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(a)oxygenxml.com > > https://www.oxygenxml.com/mailman/listinfo/oxygen-user > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 1

Re: [oXygen-user] [OXYGEN-13700] cross references in reusable content
by Oxygen XML Editor Support (Radu Coravu) 13 Mar '24

13 Mar '24

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(a)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(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 1

Re: [oXygen-user] [OXYGEN-8414] Refactoring functionality
by Oxygen XML Editor Support (Radu Coravu) 12 Mar '24

12 Mar '24

Hello Judith, Oxygen has the ability to create custom XML refactoring actions based on XSLT or XQuery and to apply such actions on multiple files from the local disk. We also have a predefined "Wrap element content" XML refactor action which would probably help in this case: https://www.oxygenxml.com/doc/versions/25.1/ug-editor/topics/predefined-ref… But unfortunately as the files are on the Ixiasoft CMS our XML refactoring actions cannot run over the files from the Ixiasoft storage. If for example you export the project to the local disk you could use the Oxygen desktop application's "XML Refactoring" tool. I think you should also consider adding a Schematron custom validation check in your Oxygen DITA framework customization to report such problems so that people will be notified when they insert text in cells without wrapping it in pargraphs. Regards, Radu Radu Coravu Oxygen XML Editor On 9/18/23 12:55, Oudkerk, Judith wrote: > > Hello, > > I was wondering if you can use the refactoring functionality do the > following: > > Replace all <entry>TEXT</entry> elements with > <entry><p>TEXT</p></entry>. In other words, add a <p> element to all > entry elements that already contain text (without a <p> element). > > I’m using Oxygen XML with Eclipse (and the Ixiasoft CCMS Web 6.3 version). > > I’ve been looking into the refactoring functionality, but I can’t find > a way to do this. > > Thanks in advance for your help. > > Kind regards, > > Judith > > > 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(a)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(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 9

[ANN] DITA-OT Day 2024 Helsinki Recordings
by Alin Belu 07 Mar '24

07 Mar '24

Hi everyone, Last month, Oxygen XML Editor hosted in Helsinki the DITA-OT Day conference, the full day conference dedicated to the DITA Open Toolkit project. We want to properly express our gratitude to everyone who contributed to making the 8th edition of the DITA-OT Day conference a success! From the DITA-OT main developers to our attendees, to the dedicated presenters and generous supporters such as Comtech, Antenna House, and Miramo, we extend our sincerest thanks for your participation and support. We're grateful for your continued involvement in shaping the future of the DITA Open Toolkit project. As we look forward to future editions with anticipation, we invite you to relive the insightful discussions and presentations by accessing the complete library of recordings and slides from this year's DITA-OT Day through the following link: https://www.oxygenxml.com/events/2024/dita-ot_day.html All the best, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Version 6.0.0 of the Oxygen Batch Documents Converter add-on is now available!
by Alin Belu 06 Mar '24

06 Mar '24

Hello everyone, We are happy to announce that *version 6.0.0* of the *Oxygen Batch Documents Converter add-on* is now available! With this update, users can now seamlessly convert XSD to JSON Schema (version 2020-12). Additionally, we have implemented enhancements related to the processing of custom-styled lists for Word to HTML/DITA conversions. Furthermore, to optimize performance and reliability, we have updated the Apache POI library, utilized for conversions from Word (only ".doc" format) and Excel, to version 5.2.5. For more information on the Oxygen Batch Documents Converter add-on (including the installation steps), you can check the page below: https://www.oxygenxml.com/doc/ug-editor/topics/batch-converter-addon.html We sincerely hope you will find this add-on helpful, and as usual, we appreciate your feedback! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Re: [oXygen-user] [OXYGEN-13251] Teaching oXygenXML about my 2-arity extension function
by Oxygen XML Editor Support (Octavian Nadolu) 28 Feb '24

28 Feb '24

Hi Ken, Thanks for the feedback. If you have a jar file with the extension function, you can add the jar in the transformation or validation scenario extensions. Find more details in our user manual: https://www.oxygenxml.com/doc/versions/26.0/ug-editor/topics/xslt-xquery-ex… If you just want to ignore the validation problem, you can use enable the ignore problems support. To do this, open the Preferences dialog box (Options > Preferences) and go to Editor > Document Validation > Ignored Validation Problems. Then you can use the quick fixes to inore the problem in the document or in all the documents. Find more details in our user manual. https://www.oxygenxml.com/doc/versions/26.0/ug-editor/topics/preferences-ig… Best Regards, Octavian On 2/22/2024 9:53 PM, G. Ken Holman wrote: > Hi! > > My editor is correctly flagging the reference to an undefined > user-defined function with arity 2. > > It happens I have extended my XSLT processor with this functionality, > so I want to teach oXygen about the existence of the function so that > it won't complain. In my environment, the stylesheet runs without > error, so I don't need the tool to tell me the reference is in error. > > Where do I do that? > > Thanks! > > . . . . . . Ken > > > > > -- > Contact info, blog, articles, etc. http://www.CraneSoftwrights.com/x/ | > Check our site for free XML, XSLT, XSL-FO and UBL developer resources | > Streaming hands-on XSLT/XPath 2 training class @US$125 (5 hours free) | > Essays (UBL, XML, etc.) http://www.linkedin.com/today/author/gkholman | > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user > -- Octavian Nadolu <oXygen/> XML Editor http://www.oxygenxml.com

2 1

Teaching oXygenXML about my 2-arity extension function
by G. Ken Holman 22 Feb '24

22 Feb '24

Hi! My editor is correctly flagging the reference to an undefined user-defined function with arity 2. It happens I have extended my XSLT processor with this functionality, so I want to teach oXygen about the existence of the function so that it won't complain. In my environment, the stylesheet runs without error, so I don't need the tool to tell me the reference is in error. Where do I do that? Thanks! . . . . . . Ken -- Contact info, blog, articles, etc. http://www.CraneSoftwrights.com/x/ | Check our site for free XML, XSLT, XSL-FO and UBL developer resources | Streaming hands-on XSLT/XPath 2 training class @US$125 (5 hours free) | Essays (UBL, XML, etc.) http://www.linkedin.com/today/author/gkholman |

1 0

Re: [oXygen-user] [OXYGEN-12915] Customizing Batch Document conversion from Word to DITA
by Oxygen XML Editor Support (Cosmin Duna) 19 Feb '24

19 Feb '24

Hi, I'm sorry, but currently, the add-on does not support setting an additional XSLT processing file. We do have an internal issue logged for this and I've added your feedback to it to help prioritize it. As you suggested, the only workaround at the moment is to post-process the resulting DITA documents using a custom refactoring operation, like in this example: https://blog.oxygenxml.com/topics/migrating_word_to_dita_bdc/frequently_ask… Regarding the issue with the image being outside the fig element, I was unable to replicate this problem. The resulting DITA document should look like this: <fig id="figureID-figure_flower"> <title>Figure Flower</title> <image href="media-image/image1.jpg"> <alt>A white flower with yellow center.</alt> </image> </fig> Could you please provide us with a sample where this problem occurs? Best regards, Cosmin -- Cosmin Duna Oxygen XML Editor On 12-Feb-24 4:14 PM, Jirka Kosek wrote: > Hi, > > we are using Batch Document converting Add-on on one project to > convert Word files into DITA content. I'm wondering if there is any > way how to customize conversion process in a more complex way than > just by mapping Word styles into HTML elements that are later mapped > into DITA (as described at > https://www.oxygenxml.com/doc/versions/26.0/ug-editor/topics/batch-converte…) > > Examples of things we would like to customize: > > * Grouping of generated DITA elements. For example Word figure with > caption is by default converted to two paragraphs -- one with image > and the second with caption. We can map Caption style to "figure > > figcaption" but this will generate DITA figure only with title, image > itself will be in the previous paragraph. If we could run simple XSLT > on the result it should be possible to automatically fix such output > to create valid and more semantically rich DITA. > > * We need to create DITA Bookmap not plain DITA Map from one Word > file. So having ability to run custom XSLT that woudl transform map > into bookmap would help us a lot. > > Of course we can implement this as an additional post-processing step > but if there is some existing integration point I've missed it would > be much easier for users just to invoke conversion from the menu. > > Many thanks in advance, > > Jirka > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 1

Re: [oXygen-user] [OXYGEN-12987] Need help with a Schematron rule
by Oxygen XML Editor Support (Radu Coravu) 15 Feb '24

15 Feb '24

Hi Frank, About the "access denied" problem, we seem to have fixed it in an Oxygen 26.1 minor bug fix release: https://www.oxygenxml.com/build_history.html?build_id=2024012406 > *Security/Schematron:* Fixed an issue regarding the validation of > Schematron documents when such files were created or saved in a > location considered not safe. So maybe you can re-download and re-install Oxygen 26.1. In the Oxygen main menu Help->About dialog besides the version you can also find the build ID information as from time to time we release newer builds of the same version to fix more severe problems. Regards, Radu Radu Coravu Oxygen XML Editor On 2/14/24 17:00, Frank Dissinger wrote: > > Hi Franz-Josef, > > > Thank you very much for your help. Your code indeed does work! I don't > know what made it fail previously... > > > Any idea about this error message which keeps popping up at the bottom > of the window when I save a Schematron rule file? > > access denied ("java.security.AllPermission" "<all permissions>" > "<all actions>") > > I can save the *.sch file despite this message, but it's annoying > because it requires an additional click on the "Save anyway" button. > > > Regards, > > > Frank > > > ------------------------------------------------------------------------ > > > Am 14.02.2024 um 13:05 schrieb Franz-Josef Knelangen: >> >> Hi Frank, >> >> the provided code works: added it to my rules.sch and removed the ph >> to catch all keyref‘ed elements: >> >> >> <sch:pattern> >> <sch:rulecontext="*[*/@keyref/*]"> >> <sch:asserttest="/not/(/contains/(/text/(),' '))">No blanks allowed >> inside keyref'ed elements</sch:assert> >> </sch:rule> >> </sch:pattern> >> >> Now it reports correctly – the yellow elements have red underlines in >> Oxy – they don’t come over with the clipboard: >> >> <?xml version="1.0" encoding="UTF-8"?> >> <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> >> <topicid="Untitled1"> >> <title>Test Schematron</title> >> <body> >> <p><ph keyref="prod-short"></ph></p> >> <p><phkeyref="prod-short"/></p> >> <p><keywordkeyref="prod-name"></keyword></p> >> <p><keywordkeyref="prod-name"/> >> </p> >> </body> >> </topic> >> >> And only these 2 in the “Problems” pod: >> >> No blanks allowed inside keyref'ed elements >> >> No blanks allowed inside keyref'ed elements >> >> Must be something else in your configuration… >> >> Greetings, >> >> Franz-Josef >> >> * >> Franz-Josef Knelangen** >> *Leiter Dokumentation >> >> Main: +49 7634 5612-0 >> >> Facebook <https://www.facebook.com/akgsoftware/>| Xing >> <https://www.xing.com/pages/akgsoftware>| LinkedIn >> <https://www.linkedin.com/company/18590571>| YouTube >> <https://www.youtube.com/c/AKGSoftware-infrastructure> >> >> AKG Software Consulting GmbH >> >> *AKG Software Consulting GmbH* >> Uhlandstr. 12 >> D-79423 Heitersheim >> www.akgsoftware.de <https://www.akgsoftware.de/> >> >> Geschäftsführer: Dipl.-Ing. Artur K. Günther, Dipl.-Ing. Arno >> Brüggemann, Dipl.-Ing. (FH) Bernhard Feser, Dipl.-Ing. Jens Günther >> Sitz der Gesellschaft: Heitersheim, HRB 310383 (Amtsgericht Freiburg >> i. Br.)** >> > -- > > *Frank Dissinger* > > Documentation Manager > > .................................................................... > > *CGS ORIS GmbH* > > *Email *frank.dissinger(a)cgs-oris.com | *Web* www.cgs-oris.com > <http://www.cgs-oris.com/> > > *Address* Kettelerstr. 24 | D-63512 Hainburg | Germany > > *Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99 > > *Commercial register* Offenbach, HRB no. 21495 > > *Managing directors* Bernd Rückert, Christoph Thommessen > > > https://www.cgs-oris.com/Signatur.png <https://www.cgs-oris.com/signatur> > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

1 0

Need help with a Schematron rule
by Frank Dissinger 14 Feb '24

14 Feb '24

Hi all, I want to write a Schematron rule which checks whether a keyref'ed element contains a blank character. WRONG: <ph keyref="mykey"> </ph> CORRECT: <ph keyref="mykey"></ph> I adapted another rule and tried the following, but it does not work as expected. In addition, it should apply to any keyref'ed element, not only to <ph>. <sch:pattern id="Check_blanks" xmlns:sch="http://purl.oclc.org/dsdl/schematron"> <sch:rule context="*[contains(@class, 'ph')][@keyref]"> <sch:assert test="not(contains(text(), ' '))">No blank allowed inside keyref'ed ph elements</sch:assert> </sch:rule> </sch:pattern> Any help would be greatly appreciated. Regards, Frank -- *Frank Dissinger* Documentation Manager .................................................................... *CGS ORIS GmbH* *Email *frank.dissinger(a)cgs-oris.com | *Web* www.cgs-oris.com <http://www.cgs-oris.com/> *Address* Kettelerstr. 24 | D-63512 Hainburg | Germany *Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99 *Commercial register* Offenbach, HRB no. 21495 *Managing directors* Bernd Rückert, Christoph Thommessen https://www.cgs-oris.com/Signatur.png <https://www.cgs-oris.com/signatur>

3 4