Add Hunspell dictionaries to Spell Checker Pro

This feature is only available for TinyMCE 5.9 and later.

TinyMCE 5.9 introduced support for Hunspell dictionaries. Hunspell dictionaries can be obtained from various sources, but the files must be stored in a specific structure to work with TinyMCE Spell Checker Pro. Tiny provides downloadable bundles that have the required structure.

To add Hunspell dictionaries to a self-hosted TinyMCE:

  1. Download the latest TinyMCE Enterprise package.

  2. Download the desired Hunspell dictionaries.

  3. Configure the TinyMCE spelling service to use the Hunspell dictionaries.

Downloadable Hunspell Bundles

Tiny provides two downloadable bundles of Hunspell dictionaries.

hunspell-dictionaries-approved.zip

Does not contain dictionaries licensed under:

hunspell-dictionaries-all.zip

This package contains all the Hunspell dictionaries that the spelling service supports. You will need to ensure that their license matches your requirements.

Hunspell dictionaries can be downloaded from other sources, but will need to be stored in the structure shown in Hunspell dictionary storage for Spell Checker Pro. Not all Hunspell dictionary languages work with Spell Checker Pro, for a list of supported languages, see: Spell Checker Pro plugin - Supported languages.

Configuring the spelling service to use Hunspell dictionaries

This feature is only available for TinyMCE 5.9 and later.

The ephox.spelling.hunspell-dictionaries-path setting is used to define the location of the Hunspell dictionaries. When the setting is not provided, Hunspell dictionaries are not supported.

Requirements:

  • The directory containing the Hunspell dictionaries must conform to the file structure defined in Hunspell dictionary storage for Spell Checker Pro.

  • The directory containing the Hunspell dictionaries must be on the same server machine (or docker container) as the java service.

Tiny recommends storing the Hunspell dictionaries in a similar location to the application.conf file. For example, if application.conf is in a directory called /opt/ephox, the Hunspell dictionaries should be stored in the subdirectory /opt/ephox/hunspell-dictionaries.

Example:

ephox {
  spelling {
    hunspell-dictionaries-path: "/opt/ephox/hunspell-dictionaries"
  }
}

Hunspell dictionary storage for Spell Checker Pro

You can remove unwanted dictionaries and their associated directories, but the file structure must be as follows (including filenames):

├── af_ZA
│   ├── af_ZA.aff
│   ├── af_ZA.dic
│   └── license
├── da
│   ├── da.aff
│   ├── da.dic
│   └── license
├── de_DE
│   ├── de_DE.aff
│   ├── de_DE.dic
│   └── license
├── en_AU
│   ├── en_AU.aff
│   ├── en_AU.dic
│   └── license
├── en_CA
│   ├── en_CA.aff
│   ├── en_CA.dic
│   └── license
├── en_GB
│   ├── en_GB.aff
│   ├── en_GB.dic
│   └── license
├── en_medical
│   ├── en_medical.aff
│   ├── en_medical.dic
│   └── license
├── en_US
│   ├── en_US.aff
│   ├── en_US.dic
│   └── license
├── es
│   ├── es.aff
│   ├── es.dic
│   └── license
├── fr
│   ├── fr.aff
│   ├── fr.dic
│   └── license
├── hu
│   ├── hu.aff
│   ├── hu.dic
│   └── license
├── it_IT
│   ├── it_IT.aff
│   ├── it_IT.dic
│   └── license
├── mi_NZ
│   ├── license
│   ├── mi_NZ.aff
│   └── mi_NZ.dic
├── nb_NO
│   ├── license
│   ├── nb_NO.aff
│   └── nb_NO.dic
├── nl_NL
│   ├── license
│   ├── nl_NL.aff
│   └── nl_NL.dic
├── nn
│   ├── license
│   ├── nn.aff
│   └── nn.dic
├── pl
│   ├── license
│   ├── pl.aff
│   └── pl.dic
├── pt_BR
│   ├── license
│   ├── pt_BR.aff
│   └── pt_BR.dic
├── pt_PT
│   ├── license
│   ├── pt_PT.aff
│   └── pt_PT.dic
├── sv_FI
│   ├── license
│   ├── sv_FI.aff
│   └── sv_FI.dic
└── sv_SE
    ├── license
    ├── sv_SE.aff
    └── sv_SE.dic

Missing Dictionaries

Where a Hunspell dictionary has not been provided, the spelling service will fallback to the built-in dictionaries for supported languages. For a list of supported Spell Checker languages, see: Spell Checker Pro plugin - Supported languages.