Failed to run pipline

KatieKelly
Posts: 15
Joined: Thu Sep 10, 2020 11:22 pm

Failed to run pipline

Post by KatieKelly » Sat Sep 19, 2020 12:56 am

This might also fall under the frameworks/dita category.

I'm using Oxygen Author 22 I'm on a new machine. When I run a transformation scenario for pdf, chm or web responsive help, I get these error messages:

Transformation failed. C:\Program Files\Oxygen XML Editor 22\frameworks\dita\DITA-OT3.x\plugins\org.dita.base\build_preprocess.xml:62: Failed to run pipeline: The entity -//Systat//DTD DITA Composite//EN /file:/C:/Users/Katherine.Kelly/Documents/SigmaPlot%20DITA/SigmaPlot_13/dita/ditabase.dtd cannot not be resolved through catalogs. For security reasons files that are not listed in the DITA-OT catalogs and are not located in the DITA-OT directory are not read.

Failed to run pipeline: The entity -//Systat//DTD DITA Composite//EN / file:/C:/Users/Katherine.Kelly/Documents/SigmaPlot%20DITA/SigmaPlot_13/dita/ditabase.dtd cannot not be resolved through catalogs. For security reasons files that are not listed in the DITA-OT catalogs and are not located in the DITA-OT directory are not read.

It looks like, if I am at all understanding this correctly, Oxygen is not finding the ditabase.dtd because it needs to be in the DITA-0T catalogs. Is this a specific directory? I've found a directory called DITA-OT3.x (it lists it in the error message). I'm not really clear on what to do.

Background that might be helpful to know: I've been using Oxygen for a few years now, and it looks like doctypes (templates?) have maybe changed (assuming I'm understanding this correctly). Several versions ago, I was using something specific for MathFlow (MathML). But then as I upgraded, I would use whatever templates were available. It seems that now after a few upgrades I am using a hodgepodge of templates (or is it doctypes or .dtds). All was working relatively well, until now. I don't know if it's because of upgrading to version 22 or if it's because I'm on a fresh machine and perhaps I don't have all the necessarily files in the necessary directories.

A difference I see, for example, is that there are MathML templates available, but it seems these are for creating mml alone, whereas before, I was able to easily (albeit with restrictions) just create a topic with mathml.

The restriction was that I ended up just creating image files of the equations. It would be optimal to be able to create equations in mathml within the content, however.

Thanks for any help, and apologies if I'm all over the place, but all of this seems related to the mathml dtd or doctype or template I'd been using before. My primary goal would be to obviously be able to generate pdfs, chm, and web responsive help, with the capability to easily insert equations using MathFlow, if that is at all still possible.

Katie

Dan
Posts: 466
Joined: Mon Feb 03, 2003 10:56 am

Re: Failed to run pipline

Post by Dan » Mon Sep 21, 2020 12:23 pm

Hello,
We implemented a restriction in the catalog resolver to avoid security issues like the transformation process reading files unrelated to the transformation. This is useful when you are using a DITA-OT in a context where the content may come from outside organization contributors. You can disable this restriction by setting "-Dargs.disable.security.checks=yes" in the transformation configuration dialog, the "Advanced" tab, in the "JVM Arguments" text field.

Regarding MathML equations, in DITA 1.3 things are simpler. The topic DTD includes the definitions for the math ML domain (DITA-OT-3.x\plugins\org.oasis-open.dita.v1_3\dtd\technicalContent\dtd\mathmlDomain.mod). So you can use the "topic" template from the File/New dialog. When you need to add a MathML equation, you can either put it inline (equation-block/mathml elements), or refer it (equation-block/mathml-ref), as explained here: https://www.oxygenxml.com/dita/1.3/spec ... hml-d.html

Maybe your specialization needs to be updated to use the DITA 1.3 DTDs. You should not convert the equations to images.
Many regards,
Dan

KatieKelly
Posts: 15
Joined: Thu Sep 10, 2020 11:22 pm

Re: Failed to run pipline

Post by KatieKelly » Thu Sep 24, 2020 5:05 am

This is so helpful. Thank you so much!

Is there a quick and easy way to update my specialization to DITA 1.3 DTD?

Regarding equations, in the past, I could use a product called MathFlow (might have been MathType) to create equations. I used image files because they weren't rendering probably in chm files. I would love to not have to use image files. I have sent an inquiry to Design Science about MathFlow for Oxygen but I have not seen a response yet (it could be buried, so I'll dig through email). I'll also look elsewhere in the forums for info about how to do this. I'd much prefer to use the actual mathml and not image files for questions, but I don't know how to create them without MathFlow/Math Type.

Thanks to your advice, I'm able to create chm and web-responsive help, so thank you!

Dan
Posts: 466
Joined: Mon Feb 03, 2003 10:56 am

Re: Failed to run pipline

Post by Dan » Thu Sep 24, 2020 11:52 am

I am glad it worked! There are some ideas about updating specializations here:
https://www.oxygenxml.com/dita/1.3/spec ... rsion.html
If you need a DITA professional advice for this, please direct your questions to the dita-user mailing list.
If you have other questions, let us know.
Many regards,
Dan

Post Reply