BasedOnStyles

Learn how to enable a style for a specific file type.

StylesPath = styles

[*.md]
BasedOnStyles = Vale, MyStyle

BasedOnStyles enables every rule in the named styles for the files a section matches.

It's a section-level setting, so it has to appear under a glob. Putting it above the first section is an error:

'BasedOnStyles' is a syntax-specific option

To apply styles to everything, use the catch-all section:

[*]
BasedOnStyles = Vale

More than one section

When several sections match a file, the most specific one's BasedOnStyles replaces the others—it doesn't add to them:

[*]
BasedOnStyles = Vale

[*.md]
# Markdown files get Microsoft *instead of* Vale, not as well as.
BasedOnStyles = Microsoft

If you want the defaults plus something extra, name them all:

[*]
BasedOnStyles = Vale

[*.md]
BasedOnStyles = Vale, Microsoft

Individual rules

Rules can be switched on or off by name, and unlike BasedOnStyles, these settings accumulate across every section that matches:

[*]
BasedOnStyles = Vale

[*.md]
# Markdown keeps everything from Vale, and adds one rule
# from a style that isn't otherwise enabled.
Microsoft.Contractions = YES

That's the way to extend your defaults for one file type without repeating them.

Turning a rule off works the same way:

[*.md]
BasedOnStyles = Vale, MyStyle

Vale.Spelling = NO

A rule can also be enabled on its own, without its style being listed at all:

[*.md]
# Only this rule runs, not the rest of Style1.
Style1.Rule = YES

Severity

The same syntax sets a rule's level, which overrides whatever the rule file declares:

[*.md]
BasedOnStyles = Vale

Vale.Spelling = warning

Setting a level for a whole style requires Vale v3.17.0 or later.

A bare style name sets the default for every rule in that style, and a rule naming itself still wins:

[*.md]
BasedOnStyles = proselint

# Everything in proselint is a suggestion ...
proselint = suggestion
# ... except this one.
proselint.Typography = warning

This is the concise way to keep one part of a style while turning the rest down—or off:

proselint = NO
proselint.Typography = YES

See MinAlertLevel for how levels affect Vale's exit code.

Related: MinAlertLevel SkippedScopes