The Latin abbreviation viz. (short for videlicet) is currently missing from the list of latinisms defined under the 025a-latinisms-with-english-equivalents.yml rule.
According to style guidelines, Latin abbreviations should be replaced with plain English alternatives such as "namely" or "specifically".
Proposed Change
Add the following regex and translation to styles/Canonical/025a-latinisms-with-english-equivalents.yml:
\b(?:viz\.(?!\w)|viz(?![\w\.])): "'specifically' or 'namely'"
Rationale & Regex Design
The proposed pattern prevents false-positive flags on domains, email addresses, and words containing viz:
viz\.(?!\w): Matches viz. (with a dot) unless it is immediately followed by a word character (e.g., matching "viz. " but ignoring "viz.com" or "viz.org").
viz(?![\w\.]): Matches viz (without a dot) unless followed by a word character or a dot (e.g., matching "viz, " or "viz " but ignoring "vizier", "vizard", or "supervise").
Reproducible Test Case
test-viz.md
<!-- Expected to trigger warnings -->
Please provide the details, viz. the names and dates.
We have three options, viz, red, green, and blue.
The results are clear viz the chart below.
<!-- Expected to pass silently (No False Positives) -->
The vizier advised the sultan.
Check the website at viz.com or viz.org.
We need to supervise the process.
Vale Linter Output:
$ vale test-viz.md
test-viz.md
2:30 error Instead of 'viz.', use 'specifically' or 'namely'. Canonical.025a-latinisms-with-english-equivalents
3:24 error Instead of 'viz', use 'specifically' or 'namely'. Canonical.025a-latinisms-with-english-equivalents
4:24 error Instead of 'viz', use 'specifically' or 'namely'. Canonical.025a-latinisms-with-english-equivalents
The Latin abbreviation
viz.(short for videlicet) is currently missing from the list of latinisms defined under the025a-latinisms-with-english-equivalents.ymlrule.According to style guidelines, Latin abbreviations should be replaced with plain English alternatives such as "namely" or "specifically".
Proposed Change
Add the following regex and translation to
styles/Canonical/025a-latinisms-with-english-equivalents.yml:Rationale & Regex Design
The proposed pattern prevents false-positive flags on domains, email addresses, and words containing
viz:viz\.(?!\w): Matchesviz.(with a dot) unless it is immediately followed by a word character (e.g., matching"viz. "but ignoring"viz.com"or"viz.org").viz(?![\w\.]): Matchesviz(without a dot) unless followed by a word character or a dot (e.g., matching"viz, "or"viz "but ignoring"vizier","vizard", or"supervise").Reproducible Test Case
test-viz.md
Vale Linter Output: