Checking the Grammar for AsciiDoc content
Validate the grammar for the written content. This functionality is added via additional plugins.
How it works
The Grazie and Grazie Professional plugins add grammar checking for various languages.
Once the plugin is installed, the IDE will highlight spelling and grammar problems in the editor. Users can also run Validation in the IDE or Validation during Continuous Integration and Delivery.
Grazie Plugin
The Grazie plugin is pre-installed for most JetBrains IDEs and offers grammar and spell checking for several languages. While support for English is included, it will detect other languages and offer the download of additional files. Once it has downloaded these files, spell checking and grammar checking is available for those languages.
This plugin is available for both paid and free versions of IntelliJ.
Grazie Professional Plugin
The Grazie Professional is an optional plugin that needs to be installed by a user to their IDE.
The required-plugin feature of the IDE will display a popup to users when they open a project and a required plugin is not installed.
To add the Grazie Professional plugin to the list of required plugins for a project, follow the instructions about Required Plugins in the online help for the IDE.
Then check in the file .idea/externalDependencies.xml
to the code repository together with all other files.
As a pre-requisite when running grammar inspections in large projects, increase the memory of the IDE as the IDE might otherwise be slow, or stall due to the lack of memory. Choose menu item
and change this, for example, to 4096 MB.This plugin is available for both paid and free versions of IntelliJ.
Project style guides
Scopes for Vale rules are available with plugin version 0.37.28+. For best scope support for strong, emphasis and link, use the AsciiDoc plugin version 0.37.38+ and the Grazie Professional version 0.3.107+. |
The Grazie Professional plugin supports project style guides.
Rules can be specific to a scope, for example, a heading or a table cell. When defining such rules, this plugin supports the following scopes:
markup
-
Any text in an AsciiDoc file.
heading
-
Any section heading.
table.cell
-
Any table cell. For now, table headings are also identified as cells.
table.caption
-
Caption of a table.
list
-
Any list item in an ordered, unordered or definition list.
link
-
Applied to the text of a link.
strong
-
Applied to any bold or strong text.
emphasis
-
Applied to any italic or emphasised text.