Spelling service settings

The following settings for the Spelling premium server-side component are optional. These settings should be added to the application.conf file described in Required configuration for the server-side components.

spelling (optional)

The Spelling service has these configurable settings:

  • hunspell-dictionaries-path

  • custom-dictionaries-path

  • dynamic-custom-dictionaries

  • num-incorrect-words-in-suggestions-request-limit

hunspell-dictionaries-path (optional)

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.

  • 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"
  }
}

custom-dictionaries-path (optional)

For information on creating custom dictionaries, see: Adding custom dictionaries - Creating custom dictionary files.

The ephox.spelling.custom-dictionaries-path element is used to define the location of the custom dictionaries. When the setting is not provided, no custom dictionaries are loaded.

Requirements:

  • The directory containing the custom dictionaries must be on same server machine as the java service.

  • The directory should not contain subdirectories or non-dictionary files.

Tiny recommends storing the custom dictionaries in a similar location to the application.conf file. For example, if application.conf is in a directory called /opt/ephox, the dictionary files could be stored in the subdirectory /opt/ephox/dictionaries.

Example:

ephox {
  spelling {
    custom-dictionaries-path = "/opt/ephox/dictionaries"
  }
}

dynamic-custom-dictionaries (optional)

Adding the ephox.spelling.dynamic-custom-dictionaries element and setting it to true instructs the spelling service to periodically check the custom-dictionaries-path for changes, and update the custom dictionaries accordingly. This allows updates to the custom dictionaries without restarting the spelling service. The default value is false.

Example:

ephox {
  spelling {
    custom-dictionaries-path = "/opt/ephox/dictionaries"
    dynamic-custom-dictionaries = true
  }
}

num-incorrect-words-in-suggestions-request-limit (optional)

Adding the num-incorrect-words-in-suggestions-request-limit element and setting it to a number instructs the spelling service to reject any requests for /2/ suggestions where the number of incorrect words exceeds the specified limit. The default is to have no limit.

Example:

ephox {
  spelling {
    num-incorrect-words-in-suggestions-request-limit = 100
  }
}