sponsor Vim development Vim logo Vim Book Ad

vim-dict : The Dict client for Vim

 script karma  Rating 10/4, Downloaded by 3071  Comments, bugs, improvements  Vim wiki

created by
Szymon Wrozynski
 
script type
utility
 
description
vim-dict

vim-dict is a dict client. It uses curl to connect to dict servers, so make sure you have curl installed.

The most recent version can be found on github: https://github.com/szw/vim-dict

Usage

To lookup a word (or words) in the dictionary use Dict command:

:Dict hello
:Dict start up

The Dict command uses hosts and databases defined in the g:dict_hosts global list. By default it is set to [["dict.org", ["all"]]] (the format will be explained a bit later).

Dict command can use a current word under the cursor. Just move the cursor to a word and type in the command line:

:Dict

You can also select words in the visual mode with help of the DictSelection command:

:DictSelection

Configuration

There are just a few global variables (options) you may set in the .vimrc file.

    g:dict_hosts

    The most important one is a list g:dict_hosts mentioned earlier. It combines hosts/databases used by vim-dict. The list entries are lists themselves and share the following format:

    ["host_name", ["database1", "database2", ...]]

    The sample extract from someone's ~/.vimrc file could look like this:

    let g:dict_hosts = [
        \["dict.org", ["all"]],
        \["dict.mova.org", ["slovnyk_en-pl", "slovnyk_pl-en"]]
    \]

    Moreover vim-dict can help you figure out what databases are available on your servers. There is a special command for this:

    :DictShowDb

    You can even open your .vimrc and provide some host urls only:

    let g:dict_hosts = [
        \["dict.org", []],
        \["dict.mova.org", []]
    \]

    Then save and reload .vimrc, perform DictShowDb and yank-paste the databases you want :).

    The list of DICT servers can be found on the internet, e.g. here.

    g:dict_leave_pw

    If set to 1 vim-dict leaves the preview window (the focus remains on the current window). By default it is set to 0.

    Example:

    let g:dict_leave_pw = 0

    g:dict_curl_command

    This variable holds the curl command to be fired by Dict function. You will find it handy if curl is not on your $PATH environment variable. By default it is set to "curl".

    Example:

    let g:dict_curl_command = "curl"

    g:dict_curl_options

    Sometimes you might want to add additional options to the curl invocation, e.g. additonal proxy settings. By default it defines only the connection timeout. Notice, the option -s (silent) is always present regardless of this variable.

    Example:

    let g:dict_curl_options = "--connect-timeout 30"

License

Copyright © 2012 Szymon Wrozynski. Distributed under the same terms as Vim itself. See :help license

 
install details
Place in ~/.vim/plugin/dict.vim or in case of Pathogen:

cd ~/.vim/bundle
git clone https://github.com/szw/vim-dict.git
 

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
vim-dict.zip 1.2.1 2013-01-01 7.0 Szymon Wrozynski Added vim help file and some minor fixes
szw-vim-dict-1.2.0.zip 1.2.0 2012-08-22 7.0 Szymon Wrozynski DictSelection is no longer necessary. Now dict command can be performed in visual mode
szw-vim-dict-1.1.1.zip 1.1.1 2012-08-21 7.0 Szymon Wrozynski New options (g:dict_curl_options, g:dict_curl_command) and a few more improvements
szw-vim-dict-1.1.0.zip 1.1.0 2012-08-19 7.0 Szymon Wrozynski Support for multiple hosts/databases. Support for show:db.
szw-vim-dict-1.0.0.zip 1.0.0 2012-08-19 7.0 Szymon Wrozynski Initial upload
ip used for rating: 18.97.14.85

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
   
Vim at Github