---

Ⅰ. 插件描述

The Dict client for Vim

Ⅱ. 基本信息

创建日期：  2012-08-18 使用用户：  36 Github星：  43 插件作者：  Szymon Wrozynski

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'szw/vim-dict'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'szw/vim-dict'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'szw/vim-dict'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

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

Ⅳ. 文档说明

vim-dict

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

Installation

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

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

Please, don't forget to star the repository if you like (and use) the plugin. This will let me know
how many users it has and then how to proceed with further development :).

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 word under the cursor. Just move the cursor to a word and type in the command line:

:Dict

The same works on selection - just select multiple words in the Visual mode.

The :Dict command will open a preview window. To close that window you may run :pc, or just hit
q if the Dict window is the active one.

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.

If you have a local server with a dict deamon, you can use:

    let g:dict_hosts = [["localhost", ["*"]]]

• 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"

Useful tips

On Ubuntu you might want to add system dictionary to Vim:

set dictionary+=/usr/share/dict/words

This will enable the dictionary in the insert mode (CTRL-X CTRL-K). Additionaly it could be useful to add the
dictionary to the standard word completions (CTRL-N...) for text and Markdown file types. To do this set the
complete to include k value:

au FileType text,markdown setlocal complete+=k

License

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