Highlights misspelling in Atom and shows possible corrections.
Use cmd-shift-: to bring up the list of corrections when your cursor is on a misspelled word.
By default spell check is enabled for the following files:
- Plain Text
- GitHub Markdown
- Git Commit Message
- AsciiDoc
- reStructuredText
You can override this from the Spell Check settings in the Settings View (cmd-,). The Grammars config option is a list of scopes for which the package will check for spelling errors.
To enable Spell Check for your current file type: put your cursor in the file, open the Command Palette
(cmd-shift-p), and run the Editor: Log Cursor Scope
command. This will trigger a notification which will contain a list of scopes. The first scope that's listed is the one you should add to the list of scopes in the settings for the Spell Check package. Here are some examples: source.coffee
, text.plain
, text.html.basic
.
To change the language of the dictionary, set the "Locales" configuration option to the IETF tag (en-US, fr-FR, etc). More than one language can be used, simply separate them by commas.
This plugin uses the existing system dictionaries. If a locale is selected that is not installed, a warning will pop up when a document that would be spell-checked is loaded. To disable this, either remove the incorrect language from the "Locales" configuration or clear the check on "Use Locales" to disable it entirely.
To get the search paths used to look for a dictionary, make sure the "Notices Mode" is set to "console" or "both", then reload Atom. The developer's console will have the directory list.
For Windows 8 and 10, this package uses the Windows spell checker, so you must install the language using the regional settings before the language can be chosen inside Atom.
If your Windows user does not have Administration privileges, you'll need to do an extra step once the language has been added to enable the spell checker. To do so, you need to install the "Basic typing" language option by following the next steps (you'll be asked for your administrator password):
Once the additional language is added, Atom will need to be restarted.
Previously, setting SPELLCHECKER_PREFER_HUNSPELL
environment variable would change how checking works. Now this is controlled by the system and locale checker to use the operating system version or Hunspell respectively.
If locale is not set, Atom will attempt to use the current locale from the environment variable; if that is missing, en-US
will be used. The dictionary for en-US
is shipping with Atom but all other locale-based checkers will need to be downloaded from another source.
On Ubuntu, installing "Language Support" may solve problems with the dictionaries. For other distributions (or if Language Support doesn't work), you may use apt
to install the dictionaries.
sudo apt-get install hunspell-en-gb
sudo apt-get install myspell-en-gb
On RedHat, the following should work for Italian:
sudo dnf install hunspell
sudo dnf install hunspell-it
You can get a list of currently installed languages with:
/usr/bin/hunspell -D
Atom may require a restart to pick up newly installed dictionaries.
A language may be installed by running:
pacman -S hunspell-en_GB
For the time being, a soft link may be required if the dictionary provided is "large".
cd /usr/share/hunspell
sudo ln -s en_GB-large.dic en_GB.dic
sudo ln -s en_GB-large.aff en_GB.aff
Spell Check allows for plugins to provide additional spell checking functionality. See the PLUGINS.md
file in the repository on how to write a plugin.