Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/beloglazov/vim-online-thesaurus

A Vim plugin for looking up words in an online thesaurus
https://github.com/beloglazov/vim-online-thesaurus

Last synced: about 2 months ago
JSON representation

A Vim plugin for looking up words in an online thesaurus

Awesome Lists containing this project

README

        

# Vim Online Thesaurus

This is a plugin for Vim allowing you to look up words in an online thesaurus,
which is at the moment configured to be http://thesaurus.com/

The plugin displays the definition of the word under the cursor and a list of
synonyms.

![](https://github.com/beloglazov/vim-online-thesaurus/raw/master/screenshot.png)

The credit for the original idea and code goes to Nick Coleman:
http://www.nickcoleman.org/

## Installation

If you are using Vundle, just add the following line to your .vimrc:

```
Plugin 'beloglazov/vim-online-thesaurus'
```

Then run `:PluginInstall` to install the plugin.

Note: Earlier versions required the "Bundle" keyword instead of plugin (i.e. :BundleInstall
and Bundle 'beloglazov/vim-online-thesaurus'). However,
this is deprecated and should not be used any longer.

## Usage

The plugin provides the `:OnlineThesaurusCurrentWord` command to look up the
current word under the cursor in an online thesaurus. Alternatively, you can
look up any word with `:Thesaurus word`.

Internally, both commands make a request to http://thesaurus.com/, parse the
results, and display them in a vertical split in the bottom.

By default the `:OnlineThesaurusCurrentWord` command is mapped to
`K`. If you haven't remapped ``, it defaults to `\`.
To close the split, just press `q`.

## Configuration

If you want to disable the default key binding, add the following line to your
.vimrc:

```
let g:online_thesaurus_map_keys = 0
```

Then you can map the `:OnlineThesaurusCurrentWord` command to anything you want
as follows:

```
nnoremap :OnlineThesaurusCurrentWord
```

Enjoy!

## Contributors

Big thanks to the following people who contributed to the development of this
plugin!

- [Derek Schrock](https://github.com/derekschrock)
- [Justin Campbell](https://github.com/justincampbell)
- [Christian Heinrich](https://github.com/Shurakai)
- [Matija Brković](https://github.com/blablatros)
- [Shahaf Arad](https://github.com/av3r4ge)

## License

Copyright (c) Anton Beloglazov, Google Inc. Distributed under the Apache 2.0
License.