---

Ⅰ. 插件描述

A vim plugin which uses ranger to explore your filesystem and to open files and directories.

Ⅱ. 基本信息

创建日期：  2015-03-09 使用用户：  5 Github星：  22 插件作者：  Tianjiao Yin

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'mizuchi/vim-ranger'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'mizuchi/vim-ranger'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'mizuchi/vim-ranger'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/mizuchi/vim-ranger

Ⅳ. 文档说明

vim-ranger

How to use it

It just works.

User Guide

ranger <http://ranger.nongnu.org/>_ is a file manager with VI key bindings.

This plugin is similar to nerdtree <https://github.com/scrooloose/nerdtree>_.
It overrides the default file browser (netrw), so if you :edit a directory a ranger will be opened.
When you open a file in ranger, it will be opened in vim.
You could also select multiple files and open'em all at once (use v to select multiple files in ranger).
BTW, don't use it with nerdtree at the same time.

Configuration

• Set ranger executable path: let g:ranger_executable = 'ranger'
• Custom command to run when ranger exits: let g:ranger_on_exit = ''
• Command used to open files: let g:ranger_open_mode = 'tabe'

Tips

You can add nnoremap <f3> :tabe %:p:h<cr> to your .vimrc so that you could use <f3> to open new files in new tab.
Clear up lingering buffers after ranger exits: let g:ranger_on_exit = 'bw!'

Known issue

1. (Only for vanilla vim) After opening ranger once and back to vim, you can't use arrow-up/arrow-down to observe vim command line ":" history doesn't work anymore (unless restart vim).
   Workaground: use Ctrl+UP/DOWN to observe history, instead of just UP/DOWN.
2. (Only for neovim) some shortcut don't work, such as "F8", "<c-h>" because of neovim limitation.

Requirement

ranger >= 1.5.1

Notes

This plugin is forked from the official ranger example here:
https://github.com/hut/ranger/blob/master/examples/vim_file_chooser.vim

There are 3 main differences

1. Unlike the original plugin, in my plugin the files are opened in tabs instead of buffers.
2. Ranger will be opened automatically when you :edit a directory. The original plugin requires to execute a vim command to open ranger.
3. My plugin supports neovim.

Copyright (C) 2015 Tianjiao Yin <ytj000@gmail.com>