2017-07-29 08:38:26 +08:00
|
|
|
The NERDTree
|
2011-12-24 18:58:57 +08:00
|
|
|
=============
|
|
|
|
|
2017-07-29 08:38:26 +08:00
|
|
|
Introduction
|
|
|
|
------------
|
2011-12-24 18:58:57 +08:00
|
|
|
|
2017-07-29 08:38:26 +08:00
|
|
|
The NERDTree is a file system explorer for the Vim editor. Using this plugin,
|
2017-07-29 08:47:14 +08:00
|
|
|
users can visually browse complex directory hierarchies, quickly open files for
|
|
|
|
reading or editing, and perform basic file system operations.
|
|
|
|
|
|
|
|
This plugin can also be extended with custom mappings using a special API. The
|
|
|
|
details of this API and of other NERDTree features are described in the
|
|
|
|
included documentation.
|
2011-12-24 18:58:57 +08:00
|
|
|
|
2017-07-29 08:38:26 +08:00
|
|
|
![NERDTree Screenshot](https://github.com/scrooloose/nerdtree/raw/master/screenshot.png)
|
2011-12-24 18:58:57 +08:00
|
|
|
|
|
|
|
Installation
|
|
|
|
------------
|
|
|
|
|
2017-03-27 02:51:09 +08:00
|
|
|
#### [pathogen.vim](https://github.com/tpope/vim-pathogen)
|
2011-12-24 18:58:57 +08:00
|
|
|
|
2016-05-23 23:59:07 +08:00
|
|
|
git clone https://github.com/scrooloose/nerdtree.git ~/.vim/bundle/nerdtree
|
2011-12-24 18:58:57 +08:00
|
|
|
|
2017-07-04 22:14:35 +08:00
|
|
|
Then reload Vim, run `:helptags ~/.vim/bundle/nerdtree/doc/`, and check out `:help NERDTree.txt`.
|
2011-12-24 18:58:57 +08:00
|
|
|
|
|
|
|
|
2017-03-27 02:51:09 +08:00
|
|
|
#### [apt-vim](https://github.com/egalpin/apt-vim)
|
2015-07-30 20:52:17 +08:00
|
|
|
|
|
|
|
apt-vim install -y https://github.com/scrooloose/nerdtree.git
|
|
|
|
|
2017-07-29 08:38:26 +08:00
|
|
|
F.A.Q.
|
|
|
|
------
|
2011-12-24 18:58:57 +08:00
|
|
|
|
2015-05-02 19:01:22 +08:00
|
|
|
> Is there any support for `git` flags?
|
2011-12-28 05:52:43 +08:00
|
|
|
|
2015-05-02 19:01:22 +08:00
|
|
|
Yes, install [nerdtree-git-plugin](https://github.com/Xuyuanp/nerdtree-git-plugin).
|
2011-12-24 18:58:57 +08:00
|
|
|
|
2016-03-06 06:03:23 +08:00
|
|
|
---
|
2012-01-04 19:44:54 +08:00
|
|
|
|
2015-05-02 19:01:22 +08:00
|
|
|
> Can I have the nerdtree on every tab automatically?
|
2012-01-04 19:44:54 +08:00
|
|
|
|
2015-05-02 19:01:22 +08:00
|
|
|
Nope. If this is something you want then chances are you aren't using tabs and
|
|
|
|
buffers as they were intended to be used. Read this
|
|
|
|
http://stackoverflow.com/questions/102384/using-vims-tabs-like-buffers
|
2012-01-04 19:44:54 +08:00
|
|
|
|
2015-05-02 19:01:22 +08:00
|
|
|
If you are interested in this behaviour then consider [vim-nerdtree-tabs](https://github.com/jistr/vim-nerdtree-tabs)
|
2012-01-04 19:44:54 +08:00
|
|
|
|
2016-03-06 06:03:23 +08:00
|
|
|
---
|
2015-05-02 19:01:22 +08:00
|
|
|
> How can I open a NERDTree automatically when vim starts up?
|
|
|
|
|
|
|
|
Stick this in your vimrc: `autocmd vimenter * NERDTree`
|
|
|
|
|
2016-03-06 06:03:23 +08:00
|
|
|
---
|
2015-05-02 19:01:22 +08:00
|
|
|
> How can I open a NERDTree automatically when vim starts up if no files were specified?
|
|
|
|
|
2015-11-27 02:57:38 +08:00
|
|
|
Stick this in your vimrc:
|
2014-06-29 19:29:49 +08:00
|
|
|
|
|
|
|
autocmd StdinReadPre * let s:std_in=1
|
2014-07-03 07:46:03 +08:00
|
|
|
autocmd VimEnter * if argc() == 0 && !exists("s:std_in") | NERDTree | endif
|
2012-01-04 19:44:54 +08:00
|
|
|
|
2015-11-27 02:57:38 +08:00
|
|
|
Note: Now start vim with plain `vim`, not `vim .`
|
|
|
|
|
2016-10-09 15:26:48 +08:00
|
|
|
---
|
2016-10-11 03:16:00 +08:00
|
|
|
> How can I open NERDTree automatically when vim starts up on opening a directory?
|
2016-10-09 15:11:27 +08:00
|
|
|
|
|
|
|
autocmd StdinReadPre * let s:std_in=1
|
2016-10-09 20:28:33 +08:00
|
|
|
autocmd VimEnter * if argc() == 1 && isdirectory(argv()[0]) && !exists("s:std_in") | exe 'NERDTree' argv()[0] | wincmd p | ene | endif
|
2016-10-09 15:26:48 +08:00
|
|
|
|
2016-10-11 03:16:00 +08:00
|
|
|
This window is tab-specific, meaning it's used by all windows in the tab. This trick also prevents NERDTree from hiding when first selecting a file.
|
2016-10-09 15:11:27 +08:00
|
|
|
|
2016-03-06 06:03:23 +08:00
|
|
|
---
|
2015-05-02 19:01:22 +08:00
|
|
|
> How can I map a specific key or shortcut to open NERDTree?
|
2013-01-01 02:15:55 +08:00
|
|
|
|
2015-05-02 19:01:22 +08:00
|
|
|
Stick this in your vimrc to open NERDTree with `Ctrl+n` (you can set whatever key you want):
|
2014-10-30 08:00:36 +08:00
|
|
|
|
2015-05-13 03:58:35 +08:00
|
|
|
map <C-n> :NERDTreeToggle<CR>
|
2013-01-01 02:15:55 +08:00
|
|
|
|
2016-03-06 06:03:23 +08:00
|
|
|
---
|
2015-05-02 19:01:22 +08:00
|
|
|
> How can I close vim if the only window left open is a NERDTree?
|
2012-01-04 19:44:54 +08:00
|
|
|
|
2015-05-02 19:01:22 +08:00
|
|
|
Stick this in your vimrc:
|
2012-01-04 19:44:54 +08:00
|
|
|
|
2015-11-14 20:01:55 +08:00
|
|
|
autocmd bufenter * if (winnr("$") == 1 && exists("b:NERDTree") && b:NERDTree.isTabTree()) | q | endif
|
2015-05-13 03:57:49 +08:00
|
|
|
|
2016-03-06 06:03:23 +08:00
|
|
|
---
|
2015-05-13 03:57:49 +08:00
|
|
|
> Can I have different highlighting for different file extensions?
|
|
|
|
|
|
|
|
See here: https://github.com/scrooloose/nerdtree/issues/433#issuecomment-92590696
|
2015-09-12 01:44:06 +08:00
|
|
|
|
2016-03-06 06:03:23 +08:00
|
|
|
---
|
2015-09-12 01:44:06 +08:00
|
|
|
> How can I change default arrows?
|
|
|
|
|
|
|
|
Use these variables in your vimrc. Note that below are default arrow symbols
|
|
|
|
|
2016-10-05 05:52:12 +08:00
|
|
|
let g:NERDTreeDirArrowExpandable = '▸'
|
|
|
|
let g:NERDTreeDirArrowCollapsible = '▾'
|