Changing the severity of DITA validation engine checks

Post here questions and problems related to editing and publishing DITA content.
chrispitude
Posts: 907
Joined: Thu May 02, 2019 2:32 pm

Changing the severity of DITA validation engine checks

Post by chrispitude »

Hi all,

Some serious DITA validation issues, such as missing image files, are reported as warnings rather than errors. For example,

Code: Select all

Main validation file: C:\...omitted...\description_of_output_files.dita
Scenario name: DITA
Document type: Synopsys DITA Topic
Engine name: DITA Validation
Severity: warning
Description: Key definition 'refman_runset_func' not found in the DITA Map. Keys are gathered from the root map: icvug1.ditamap.
Is there a way to modify the severity of a particular check? I searched the forums and the documentation, so I hope the answer is not obvious. :)

Thanks!
Radu
Posts: 8992
Joined: Fri Jul 09, 2004 5:18 pm

Re: Changing the severity of DITA validation engine checks

Post by Radu »

Hi Chris,

According to the DITA standard a missing key reference is not a fatal processing error, for example the DITA OT reports it as an information message, we chose to report it as a warning message.
We do not have an easy way to increase the severity level for missing key refs. There is an Oxygen plugin API which is notified whenever errors are encountered but before they are presented to the end user. For example this Javascript based plugin uses the validation problems filter API to remove certain problems before they are presented to the end user:
https://github.com/oxygenxml/wsaccess-j ... lemsFilter

but our reported problems also have a method to modify their severity:
https://www.oxygenxml.com/InstData/Edit ... erity-int-

so the plugin could probably be modified to increase the severity on certain problems instead of filtering out problems.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply