Skip to content

j-f1/forked-WebsterParser

 
 

Repository files navigation

WebsterParser

Build

A better dictionary for your mac

In the a blog post named “You’re probably using the wrong dictionary”, James Somers proposes using Webster’s Unabridged Dictionary as it provides more evocative and accurate definitions than most modern dictionaries.

The text of the 1913 version has been digitized and can be found on Project Gutenberg. Unfortunately the text files are in a very arcane format. Being created before UTF-8 was commonly used, it specifies a lot of non-standard entities to encode the all the various accents and special symbols.

This project parses these original text files and creates a reasonably clean UTF-8 XML version which can be converted into a mac dictionary file with Apple’s Dictionary Kit.

Screenshot of the dictionary

How to build

Requirements

  • Node.js
  • Xcode
  • Apple’s Dictionary Developer Kit
    • Install instructions (as of 2020-02-08):
      1. Visit More Downloads for Apple Developers and log in
      2. Search for “dictionary”
      3. Download the “Additional Tools for Xcode” that corresponds to the version you have installed
      4. Open the DMG
      5. Drag the “Dictionary Developer Kit” to /Applications/Utilities
        • Recent versions of macOS will require you do this via the GUI to properly authenticate

With Node.JS installed, run

npm install
npm start
cd template
make all
make install

Building the dictionary might take a while (around three minutes on my machine)

Just want the .dictionary file?

Download it in the releases section of this project.

Using it on iOS?

You can use the dictionary file on your iDevice if it is jailbroken. SSH into your device and navigate to /private/var/mobile/Library/Assets/com_apple_MobileAsset_DictionaryServices_dictionary2. On your iDevice dowload any new stock dictionary (Select a word -> Define -> Manage -> Download) that you don't need. In your SSH browser find out which folder was just added. Navigate to folderwithcrypticnumber/AssetData. Replace the .dictionary folder with the webster.dictionary folder, but keeping the name. You should now be able to lookup words.

I don't know how to change the name of the dictionary in the list, pointers are welcome.

About

Convert Webster's Unabridged 1913 dictionary in to a more usable format

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 81.0%
  • CSS 12.9%
  • Makefile 6.1%