Workaround for Vale AsciiDoc alerting issues for certain document attributes in header

[emteelb]

Wanted to report some odd Vale behavior when linting AsciiDoc (.adoc) files.

With these document attributes in the document header, was getting incorrect and incomplete Vale alerting:

• toc
• sectnums
• title-page

Current workaround is to remove these attributes from document headers, specify toc and title_page as attribute arguments (-a toc -a title-page), and use the --section-numbers argument when running asciidoctor-pdf to generate PDF versions of documents.

An example of an incorrect Vale alert was an alert about a mispelled word in a code block.

After using the workaround, alerts are correct and their count goes up.

Before:

✖ 4 errors, 6 warnings and 0 suggestions in 1 file.

After:

✖ 7 errors, 15 warnings and 0 suggestions in 1 file.

NOTE: Running vale here with the default --minAlertLevel=warning which is the reason for no suggestions reported.

Enclosing the AsciiDoc document header between pass:[<!-- vale off -->] and pass:[<!-- vale on -->] worked as far as Vale linting correctly went, but unfortunately the PDF does not render correctly with this change so this is not a viable workaround.

Hope this helps someone. If this seems appropriate for filing a project issue, lmk.