Disabling Schematron

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
4everJang
Posts: 20
Joined: Mon Oct 14, 2013 2:12 pm

Disabling Schematron

Post by 4everJang » Fri Oct 02, 2020 2:08 pm

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

Radu
Posts: 7315
Joined: Fri Jul 09, 2004 5:18 pm

Re: Disabling Schematron

Post by Radu » Fri Oct 02, 2020 3:40 pm

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

4everJang
Posts: 20
Joined: Mon Oct 14, 2013 2:12 pm

Re: Disabling Schematron

Post by 4everJang » Wed Oct 28, 2020 3:35 pm

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

Radu
Posts: 7315
Joined: Fri Jul 09, 2004 5:18 pm

Re: Disabling Schematron

Post by Radu » Wed Oct 28, 2020 4:04 pm

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

sorin_carbunaru
Posts: 354
Joined: Mon May 09, 2016 9:37 am

Re: Disabling Schematron

Post by sorin_carbunaru » Fri Nov 20, 2020 2:45 pm

Hi,

The rule has been removed in Oxygen 23 :).

All the best,
Sorin Carbunaru

Post Reply