
Dictionary
Note: As of version 5.2.0, eLibrary Manager provides tooling to manage online dictionary definitions as an alternative to managing those through direct file system access. More recent versions of Android restrict access to private application storage where the dictionary definition file resides, so this new tooling will hopefully help alleviate that. See Online Dictionaries Manager for more information.
The ePub Reader enables dictionary lookup using web based dictionaries that can be configured, as well as using offline dictionary applications. A set of online dictionaries is enabled by default, and you can modify the list to include your favourites. Also, ePub Reader provides integration for a number of offline dictionary applications, allowing you to select from those installed on your device.
Online Dictionaries
In order to enable a web based dictionary, you need to know the URL that you can use to invoke a lookup, and that URL must include the word you wish to pass to it. To add a new dictionary to the available set, you must update the online dictionary definition file to capture the new dictionary definition. The definition record includes the name that will be used to identify the dictionary mapped to the URL to invoke in a browser with the word parameter identified by the string "{word}".
Note: Prior to version 5.2.0 of eLibrary Manager, custom dictionary definitions were managed using individual files for each definition. That has now been simplified to consolidate all definitions into a single mapping file, consistent with how other extensions are managed. If you use the new tooling to update online dictionaries, any existing configuration is migrated to the new format.
Manage Online Dictionary Definitions
To define new online dictionary definitions or to override pre-configured definitions, create the following mapping file on your SD card, if you are using the full version of eLibrary Manager:
/Android/data/kpw.ebook/files/dictionary/dictionary.txtor, if you are using the free version of eLibrary Manager
/Android/data/kpw.ebook0/files/dictionary/dictionary.txtTo add or update definitions, add entries in the file formatted as follows:
<dictionary_name>=<dictionary_url>An example of an online definition record is (note the placeholder representing the word to lookup)
Merriam-Webster Dictionary=https://www.merriam-webster.com/dictionary/{word}To override any of the pre-configured dictionaries, simply add an entry in the definition mapping file with the same name. The new configuration specified in the definition file entry will override the pre-defined value. If the replacement definition value is empty, it will remove the pre-configured dictionary from the list (if you want to prune).
Bundled pre-configured online dictionary configurations include:
The above online dictionary web URLs were gleaned from The DICT Development Group, if you're interested in finding out more.
Offline Dictionaries
By default, ePub Reader provides integration with the offline dictionary apps listed below. If any of those dictionary apps are installed on your device, they will be presented as selection options when performing a dictionary lookup.
Integration with external dictionary applications requires that eLibrary Manager declare that relationship in its manifest. That means that offline dictionary definitions cannot be configured by end users. If you have a favourite offline dictionary that you would like to use with ePub Reader that is not already supported, contact me at my support email and I will try and add that support.
Offline dictionary app integrations include (links may not work if app is no longer available on Google Play or is not available in your geography):