https://github.com/gromnitsky/wordnut
Emacs major mode interface to WordNet lexical database
https://github.com/gromnitsky/wordnut
emacs wordnet
Last synced: 5 months ago
JSON representation
Emacs major mode interface to WordNet lexical database
- Host: GitHub
- URL: https://github.com/gromnitsky/wordnut
- Owner: gromnitsky
- License: gpl-3.0
- Created: 2015-09-12T04:43:31.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-12-29T07:39:24.000Z (10 months ago)
- Last Synced: 2025-04-02T20:22:15.809Z (7 months ago)
- Topics: emacs, wordnet
- Language: Emacs Lisp
- Size: 107 KB
- Stars: 50
- Watchers: 5
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Major mode interface to WordNet
Uses wn(1) for searching local wordnet db; injects results into
`*WordNut*` buffer.
## Features
* Nothing to configure (except for optional custom keybindings).
* **Completion** if wn(1) finds the query too ambiguous.
* 1 buffer `*WordNut*` for all query results.
* Back/forward/view history.
## Requirements
* Emacs 24.4+
* wn(1) in `PATH`
* (optionally)
[adaptive-wrap](http://elpa.gnu.org/packages/adaptive-wrap.html)
## Installation
If you have adaptive-wrap mode installed, wordnut will automatically
use it to improve the text formatting (don't forget to add `(require
'adaptive-wrap)` in `~/.emacs`).
### Fedora
# dnf install wordnet
In `~/.emacs`:
(add-to-list 'load-path "/the/dir/with/the/repo")
(require 'wordnut)
### Windows
1. You need a compiled Windows version of Wordnet 3.0. Googling gives
us a bizzare
[WordNet 3.0 windows visual studio](http://sourceforge.net/projects/wordnet30forwin/files/WordNet%203.0/3.0.2/WordNet_3.0_win32.zip). Extract
`bin` & `dict` directories from it to `c:\Program
Files\WordNet\3.0\` (for some reason the path is hard-coded).
2. In `%APPDATA%\.emacs`:
(if (eq 'windows-nt system-type)
(progn
(add-to-list 'load-path "/the/dir/with/the/repo")
(setq wordnut-cmd "c:/Program Files/WordNet/3.0/bin/wn.exe")
(require 'wordnut)))
## Keyboard shortcuts
There is no default global keybindings. Add something like:
(global-set-key [f12] 'wordnut-search)
(global-set-key [(control f12)] 'wordnut-lookup-current-word)
to begin with.
In the `*WordNut*` buffer:
kbd | desc
-------------------------- | -------------
Enter | Lookup a word under the cursor
o | A tooltip w/ a _sense_ for the current _lexical category_
/ | New search
l, r | Move backward/forward in history
h | View history
q | Hide buffer
Auxiliary:
kbd | desc
------------------------------------ | -------------
M-Up, M-Down | Move between sections
Space | PageDown
b, Backspace | PageUp
## Senses overview
When reading long entries it's easy to get lost in the number of word
_senses_. For example, do `M-x wordnut-search RET part RET`. The verb
_part_ contains 12 senses. Its Synonyms/Hypernyms section has an
entry:
~~~
** Sense 3
depart, part, start, start out, set forth, set off, set out, take off
=> leave, go forth, go away
Phrasal Verb-> part with#1
~~~
To which meaning of all senses it exactly corresponds? You could
scroll back to the overview section, manually find the _verb_ section
& look into the item 3. Then you scroll back.
Instead of doing this, press o when the cursor is somewhere
in the `Sense 3` subsection to auto-retrieve the text from the
overview. If you press o (or Enter) when the
curson is inside `part with#1`word, it gets you to the wordnet entry
_part with_ → _verb_ → _sense 1_. To return to the _part_ word, press
l.
## Bugs
* ≈ 18KB is too much for such a small major mode.
## TODO
* Display a lexical category in the echo area akin to eldoc.
* Custom URI handler for `wordnut:part%20with#verb/1`.
* Mouse support.
## Credits
The inspiration was [wn-org.el](http://emacswiki.org/emacs/wn-org.el)
mode.
## License
GPLv3+.