Ignore menu:[] and btn:[] markup in AsciiDoc

[daobrien]

Given this example:
"If prompted, click btn:[OK, Don't Show Again]."

How can I ignore or not process the content of the brackets? I need this to apply to button and menu markup, etc., because in some cases (this one) the content triggers one or more Vale rules. In this case it triggers our contractions rule.

We can't say "ignore content in brackets"; we need the configuration to only apply to this type of markup. I thought it might be possible with IgnoredClasses but I can't get that to work.

Thanks for any pointers.

[daobrien]

Update:
Is it possible to arrange this so that only some Vale styles are ignored? E.g., we have a style that says "Don't include punctuation on button and menu names, even if it appears in the UI", which means that a UI button of Save as... is documented as Save as.

In AsciiDoc:
btn:[New Folder...] should be btn:[New Folder]

Ignoring this markup altogether, rather than choosing not to apply some rules to this markup, means we have to do these tests manually.
Thanks

[jdkato]

You can ignore it with IgnoredClasses:

StylesPath = styles

IgnoredClasses = button

[asciidoctor]
experimental = YES

[*.adoc]
BasedOnStyles = Vale

And then write a rule that looks for Save as... using scope: raw.

[daobrien]

Can I do something similar for the contractions style or is that going to require a different approach?

thanks a lot
David

[jdkato]

What do you mean by "contractions style"?

[daobrien]

This is our version (which I've just realised is not as elegant as it could be :) )

extends: existence
message: "Remove contraction '%s'."
level: error
ignorecase: true
tokens:
    - "it's"
    - "that's"
    - "there's"
    - "let's"
    - "you'[a-z]*"
    - "[a-z]+'t"

If Vale hits a contraction in body text ("You can't do that") then it should flag it. If it's part of a button or menu (btn:[That's ok]) it should ignore it.

[jdkato]

Yes: If you ignore the relevant classes, then no non-raw scoped rules will trigger on those elements.

[daobrien]

Thanks. I'll give it another go today and see how I go.