Transform | Vale
Ctrlk
HomeStudioGeneratorExplorerLibrary
x-twittermediumdiscordyoutube
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 applies to the files Vale reads as XML, .xml and .xsd, and it is a section-level setting, so different parts of a project can use different stylesheets:

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

[schemas/*.xsd]
Transform = xsd/html.xsl

DITA has a converter of its own and does not use this key; see DITA.

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.

PreviousCommentDelimiters
NextWordTemplate

Last updated