Transform

Learn about how to convert XML to HTML for linting.

StylesPath = styles

[*.xml]
BasedOnStyles = Vale

Transform = docbook-xsl-snapshot/html/docbook.xsl

Transform names a version 1.0 XSL Transformation (XSLT) that converts the matched files to HTML. Vale lints the result, following the same rules it uses for HTML.

It's a section-level setting, so different XML dialects can use different stylesheets:

[*.dita]
Transform = dita/html.xsl

[*.docbook]
Transform = docbook/html.xsl

Paths

A relative path is resolved against the directory holding your .vale.ini—not the working directory, and not your StylesPath. A leading ~ is expanded.

# Both of these are relative to .vale.ini:
Transform = xsl/docbook.xsl
Transform = ../shared/docbook.xsl

# Absolute and home-relative paths work too:
Transform = ~/xsl/docbook.xsl

Requirements

The conversion is performed by xsltproc, which has to be installed and on your $PATH. See XML for how to install it.

Related: XML CommentDelimiters