Ⅰ. 插件描述
:dragon: Dark powered asynchronous unite all interfaces for Neovim/Vim8Ⅱ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin 'shougo/denite-nvim'
… 然后在Vim中运行以下命令:
:source %
:PluginInstall
对于Vundle版本 < 0.10.2,请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle 'shougo/denite-nvim'
… 然后在Vim中运行以下命令:
:source %
:NeoBundleInstall
使用VimPlug管理器安装
在你的.vimrc下添加:Plug 'shougo/denite-nvim'
… 然后在Vim中运行以下命令:
:source %
:PlugInstall
使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/shougo/denite.nvim
Ⅳ. 文档说明
denite.nvim
Note: Denite.nvim does not define any of default mappings. You need to define
them.
About
Denite is a dark powered plugin for Neovim/Vim to unite all interfaces.
It can replace many features or plugins with its interface.
It is like a fuzzy finder, but is more generic.
You can extend the interface and create the sources.
Some things you can do with it include:
- Opening files
- Switching buffers
- Inserting the value of a register
- Changing current directory
- Searching for a string
Unite.vim was meant to be like Helm for Vim.
But the implementation is ugly and it's very slow.
Denite resolves Unite's problems. Here are some of its benefits:
- Theoretically faster because the main process is executed by Python
- Theoretically more stable because no other processes can be performed when
- runs.
- The implementation is simpler than unite
- Has greater potential to implement new features
- Python3 is easier to work with than Vimscript
- There are a lot of useful tools to keep code simple (linter, tester, etc...)
- Python3.
- Unite is officially obsolete, minor bugs (or even major bugs) are
- fixed anymore
Requirements
Denite requires Neovim 0.3.0+ or Vim 8.0+ with if_python3
.
If :echo has("python3")
returns 1
, then you're done.
Note: Please install/upgrade msgpack package (1.0.0+).
https://github.com/msgpack/msgpack-python
Note: You need to install Python 3.6.1+.
For neovim:
You must install "pynvim" module with pip
pip3 install --user pynvim
If you want to read the pynvim/python3 interface install documentation,
you should read :help provider-python
.
For Vim8:
Please install nvim-yarp plugin for Vim8.
https://github.com/roxma/nvim-yarp
Please install vim-hug-neovim-rpc plugin for Vim8.
https://github.com/roxma/vim-hug-neovim-rpc
You must install "pynvim" module with pip
pip3 install --user pynvim
For Windows users
- Install Vim from [Vim Win32 Installer
releases](https://github.com/vim/vim-win32-installer/releases) - Download [Python latest embeddable zip
file](https://www.python.org/downloads/windows/) and copy the all files in
the zip file to the folder where you installed Vim.
Note: You need to do 1. and 2. with the common-arch files (x86 or x64).
Installation
For dein.vim
call dein#add('Shougo/denite.nvim')
if !has('nvim')
call dein#add('roxma/nvim-yarp')
call dein#add('roxma/vim-hug-neovim-rpc')
endif
For vim-plug
if has('nvim')
Plug 'Shougo/denite.nvim', { 'do': ':UpdateRemotePlugins' }
else
Plug 'Shougo/denite.nvim'
Plug 'roxma/nvim-yarp'
Plug 'roxma/vim-hug-neovim-rpc'
endif
Examples
" Define mappings
autocmd FileType denite call s:denite_my_settings()
function! s:denite_my_settings() abort
nnoremap <silent><buffer><expr> <CR>
\ denite#do_map('do_action')
nnoremap <silent><buffer><expr> d
\ denite#do_map('do_action', 'delete')
nnoremap <silent><buffer><expr> p
\ denite#do_map('do_action', 'preview')
nnoremap <silent><buffer><expr> q
\ denite#do_map('quit')
nnoremap <silent><buffer><expr> i
\ denite#do_map('open_filter_buffer')
nnoremap <silent><buffer><expr> <Space>
\ denite#do_map('toggle_select').'j'
endfunction