Support for Schematron files

“Schematron” refers to a rule-based validation language used to define tests for an XML file. Web editor supports Schematron files. You can import the Schematron files and also edit them in Web Editor. Using a Schematron file you can define certain rules and then validate them for a DITA topic or a map.

Import Schematron files

Perform the following steps to import the Schematron files:

Validate a DITA topic or map with Schematron

After importing Schematron files, you can edit them in the Web Editor. You can use the Schematron files to validate the topics or a DITA map. For example, you can create the following rules for a DITA map or topic:

When you open a topic in the Web Editor, a Schematron Validation panel appears in the right. Perform the following steps to add and validate a topic or map with a Schematron file:
{width="300"}

The Schematron support in the Web Editor helps you in validating the files against a set of rules and maintaining consistency and correctness across the topics.

Use assert and report statements to check for rules schematron-assert-report

AEM Guides also supports the assert and report statements in Schematron. These statements help you validate your DITA topics.

Assert statement

An assert statement generates a message when a test statement evaluates to false. For example, if you want your title to be bold, you can define an assert statement for it.

<sch:rule context="title">
    <sch:assert test = "b"> Title should be bold </sch:assert>
  </sch:rule>

When you validate your DITA topics with the Schematron, you get a message for the topics where the title is not bold.

Report statement

A report statement generates a message when a test statement evaluates to true. For example, if you want the short description to be less than or equal to 150 characters, you can define a report statement to check the topics where the short description is more than 150 characters.
When you validate your DITA topics with the Schematron, you get a complete report of the rules where the report statement evaluates to true. So, you get a message for the topics where the short description is more than 150 characters.

<sch:rule context="shortdesc">
        <sch:let name="characters" value="string-length(.)"/>
        <sch:report test="$characters &gt; 150">
        The short description has <sch:value-of select="$characters"/> characters. It should contain more than 150 characters.
        </sch:report>
    </sch:rule>

Use Regex expressions schematron-regex-espressions

You can also use Regex expressions to define a rule with matches() function and then perform validation using the Schematron file.

For example, you can use it to display a message if the title contains only one word.

<assert test="not(matches(.,'^\w+$'))">
No one word titles.
</assert>

Define abstract patterns schematron-abstract-patterns

AEM Guides also supports abstract patterns in Schematron. You can define generic abstract patterns reuse these abstract patterns. You can create placeholder parameters that specify the actual pattern.

Using abstract patterns can simplify your Schematron schema by reducing the duplication of rules and making it easier to manage and update your validation logic. It can also make your schema easier to understand, as you can define complex validation logic in a single abstract pattern that can be reused throughout the schema.

For example, the following XML code creates an abstract pattern and then the actual pattern refers to it using the id.

<sch:pattern abstract="true" id="LimitNoOfWords">

<sch:rule context="$parentElement">

<sch:let name="words" value="string-length(.)"/>

<sch:assert test="$words &lt; $maxWords">

You have <sch:value-of select="$words"/> letters. This should be lesser than <sch:value-of select="$maxWords"/>.

</sch:assert>

<sch:assert test="$words &gt; $minWords">

You have <sch:value-of select="$words"/> letters. This should be greater than <sch:value-of select="$minWords"/>.

</sch:assert>

</sch:rule>

</sch:pattern>

<sch:pattern is-a="LimitNoOfWords" id="extend-LimitNoOfWords">

<sch:param name="parentElement" value="title"/>

<param name="minWords" value="1"/>

<param name="maxWords" value="8"/>

</sch:pattern>