Page 1 of 1

Disabling Schematron

Posted: Fri Oct 02, 2020 2:08 pm
by 4everJang
Short question: How do I disable Schematron ?

I am working on a huge conversion project and there can be lots of things wrong with the DITA files that are produced. Unfortunately, the Problems window is filled with an enormous amount of warnings from Schematron, which are not at all relevant at this point. So I would really like to tell Schematron to go and take a hike. But I am not finding that option in the Preferences.

Thanks in advance for a quick reply

4everJang

Re: Disabling Schematron

Posted: Fri Oct 02, 2020 3:40 pm
by Radu
Hi Jang,

So you get these Schematron errors when opening DITA topics and validating them, right?
As far as I know the default Schematron validation that we provide for DITA topics is minimal, can you give me an example of an error message that you receive? Or did you add extra Schematron validation to the DITA topics?
If you look in the Preferences->Document Type Associations page, edit the "DITA" framework, it should have a "Validation" tab where it lists its default validation scenarios. The validation scenario is named "DITA", it can be edited and it has several validation stages, you can remove the Schematron validation stages from there.

Regards,
Radu

Re: Disabling Schematron

Posted: Wed Oct 28, 2020 3:35 pm
by 4everJang
Hello Radu,

Thanks for the info. I will check on my options to change the schematron rules or switch that validation off completely. The rule that is bothering me is "In cases where a topic contains only one paragraph, then it is preferable to include this text in the shortdesc element and leave the topic body empty." It is my job to convert the legacy content into valid DITA, not to do any content curation. Also, I would not equate any content in the topic body with the shortdesc element, even though the DITA specs state that the single paragraph in the short description is supposed to be rendered as the first paragraph in the topic body. That, in my view, is a fallacy. Short descriptions are to help a user decide which of the 100 hits on a search is going to give the answer - usually the short description is NOT contained literally in the topic body itself.

Anyway, that is just my philosopher's point of view. I know where to look for getting rid of the warnings. I am getting about 9000 of them and I am only interested in the meaningful messages that might also appear when validating the complete content.

Kind regards

Jang

Re: Disabling Schematron

Posted: Wed Oct 28, 2020 4:04 pm
by Radu
Hi Jang,

I understand and agree, I'm also not a big fan of that rule although I think I added it quite a long time ago. I will add an internal issue to consider removing it. I consider this is the kind of rule which can be added by a specific team which needs it and not built in Oxygen.

Regards,
Radu

Re: Disabling Schematron

Posted: Fri Nov 20, 2020 2:45 pm
by sorin_carbunaru
Hi,

The rule has been removed in Oxygen 23 :).

All the best,
Sorin Carbunaru