Schematron Overview

Schematron enables you to enforce content architecture rules for your authoring team.

Schematron Use Case

Schematron is a perfect solution if you want to validate your DITA content architecture by enforcing structural rules specific to your organization. For example, you can define a rule that enforces an unordered list element to have at least two list item elements.

To enable Schematron in your easyDITA instance, contact your CSM.

If you aim to extensively validate the language layer of your content for grammar and style, consider integrating your easyDITA instance with an external language-validation tool (for example, HyperSTE). For more information, contact your Customer Success Manager.

Basic Schematron Rules

When Schematron is enabled, easyDITA continuously evaluates your content and structure against any configured Schematron rules. When it detects a match, easyDITA surrounds the matching content with an orange border, and inserts a tick mark in the right side of the topic editor. Hover over the tick mark to review the triggered easyDITA rule.

Schematron Rules with QuickFix

Basic Schematron rules can be extended to trigger defined QuickFix activities with a click of a button. Currently, the QuickFix implementation in easyDITA enables you to either add or replace XML nodes, that is, elements or attributes.

Schematron Rules Development

Out of the box, easyDITA provides a number of generic Schematron rules.

To implement custom Schematron rules, contact your Customer Success Manager. You can compose the rules on your own and provide them to Jorsek for installation in your instance. A second option is to have Jorsek Professional Services1 develop the rules..

1 This is a paid service.