f343f5dd0d
4dada8c04 update version number to 5.0.0 be8f18914 remove some unneeded header comments f486403b6 add license file 024966c7a move changelog out of the main doc, remove credits section e4891632f update changelog 0c13ebc12 remove some old commented code e27ab9c5c fsmenu: use nerdtree#echo* methods instead of reimplementing them 5b7085d9a fs menu: remove unused var assigns adc11983b fs_menu: put the NERDTreeListNode* methods together b19995b14 Merge pull request #382 from PhilRunninger/master 3fb18e739 Switch to upper case DIR /Q, in true DOS fashion f1af61ddf Use the system('DIR /Q...') function to display file info. c60f40137 Merge (p)roperties (for Windows) into the (l)ist menu item. fb030bcb1 Merge pull request #1 from scrooloose/master 47c20c4b6 Merge pull request #378 from Xuyuanp/up/master d38438209 Merge pull request #470 from egalpin/master af13d3965 Merge pull request #488 from hiberabyss/master caca3af21 Merge pull request #496 from evindor/master 3092ddf83 Merge pull request #502 from JESii/master 88104d26a Add ability to list file metadata... 8996ea5bb Fix MacOS detection for menu, fixes #478 34630f392 issue #147: add support to ~ expand in bookmarks 0b44415a3 Merge pull request #486 from Xuyuanp/syntax 43012a621 Merge pull request #484 from PickRelated/master d66370a8e Made NERDTreeFlags contained in NERDTreeExecFile 8c8c79410 Added character escaping to syn match regexes 8c7534bc9 Merge pull request #482 from PickRelated/master dc29ec2db Added global variables for changing default arrows g:NERDTreeDirArrowExpandable g:NERDTreeDirArrowCollapsable 188bd9265 Added global variables for changing default arrows bcf3de4fd Merge pull request #471 from SchDen/patch-1 f5fd12183 Incorrect path to event.vim 37f7a6cbe Update README.markdown 86e2e40af Merge pull request #466 from toiffel/master 93c9726c6 Fixed case-sensitive sorting of tree nodes when 'ignorecase' option is on 96c07746b Merge pull request #453 from WoLpH/patch-1 013c607ba Fixed incompatibility with older Vim versions af85499ed rename 2 sort key related vars 99fa465b5 fix syntax error 008b62f71 Merge pull request #450 from vtsang/master 6018af36b pretty up some FAQ code blocks 2c1ebc37b add an FAQ about highlighting file with certain extensions dfe260d1d doc the path listener API 10261d60a Updated the comment 80e184df5 Refactor code to use getSortKey() and replace regular expression with simple string comparison in tree_dir_node.vim 3fb3fe347 Merge branch 'master' of https://github.com/vtsang/nerdtree 57d5bd773 Speed up sortChildren() by using sorting token This improves the sorting functions from 12 seconds to 0.66 seconds for ~4000 objects 1f2531ec3 Speed up sortChildren() by using sorting token This improves the sorting functions from 12 seconds to 0.66 seconds for ~4000 objects a87b1bf3c Merge branch 'update_reuse_option' 5c2060149 doc NERDTreeAddPathFilter() 76dbc0c8e Merge branch 'add_path_filter_api' da3874cf9 fix a bug when opening files in a new tab 727021221 bugfix for secondary trees occurring when the screen state is saved 64a9579c1 add a path filter API 09e1dbec1 Merge branch 'refactor_autoload' fc4bcb480 remove UI.lolcats()... not sure what the story is there 8b189cb26 move some rendering and cursor moving functions out of autoload b0114d202 move dumpHelp out of autoload 53d2de86e move the closeTree functions out of autoload 0d88ce946 move isTreeOpen() out of autoload 8270b6d71 move nerdtree#getTreeWinNum out of autoload 973c9906f refactor 3 more functions out of the monolithic autoload file 0e87d45e8 update readme to add an FAQ, update the FAQ style and rm the changelog f8499462c Revert "Use different arrow characters for compatibility." 186f817f5 Revert "fix one of the old style arrows" 5cec19365 Merge pull request #411 from xdl/master b3281cc63 fix one of the old style arrows 87b27802b allow control over whether to reuse windows in different tabs 1cbd52aa7 Merge pull request #434 from handcraftedbits/master cd5f1685b Merge pull request #436 from devmanhinton/patch-1 321de6036 Remove NERD_tree.txt typo f6cad7e95 Use different arrow characters for compatibility. 6dfbcd660 Return early if exception was thrown in pathForString 3b98a7fca Merge pull request #403 from gcmt/pretty-cwd ba2604474 Truncate paths at slashes. f8fd2ecce Merge pull request #390 from zhangoose/patch-1 a895a53f1 easier to read one of the FAQ answers 3d421b8ec use the built in fnamemodify() to make a path relative 3ce33f017 fix escaping for `:edit` when renaming files 031ab5267 Merge remote-tracking branch 'origin/master' 5d0626a00 Merge pull request #384 from gastropoda/reopen-after-rename 1c0814622 apply @mixvin's windows path fix at the top of the method instead cd8d87fa5 Fix opening file path, in Windows 2fd0aa3ec Fix reloading renamed file 6ccf83df2 Add menu option to display file/directory properties. 5d1945228 Merge branch 'master' into up/master 8e06723c0 fix #363 a283c0e03 fix #363 4f1e6ecb0 Merge pull request #365 from ifsred/master c4086667e Fix doc map for NERDTreeMapChangeRoot a47c6caf8 Merge pull request #359 from Xuyuanp/up/master 8cd045d0e add refreshDirFlags method to avoid refreshing too many files c2dd75086 move nerdtree#treeExists.* methods into the NERDTree class fd14757c0 add proper events and make the notifier class generic f9a933991 allow plugins to override the default mappings aa831e242 Merge pull request #356 from alvan/patch-2 0c045d85e fix a bug from recent refactoring RE some NERDTreeCWD 2f552e116 add highlighting for flags 579d96a0f remove testing git plugin 9f351de59 Merge branch 'master' into expt_add_path_flags_and_git 1e0d1cbc8 move some more view code into the UI class 98a5d1fca Use event BufLeave instead of BufWinLeave to record screen state to avoid undefined b:NERDTree error 2f59cc208 Merge branch 'master' into expt_add_path_flags_and_git eaa66aaf6 fix the NERDTreeFind command - broken in recent refactoring 864462200 Merge branch 'master' into expt_add_path_flags_and_git 410081a60 Merge pull request #353 from lucascaton/master 1784de15d Updating creator.vim file (this fixes #352) 7f36008e8 Merge branch 'master' of github.com:scrooloose/nerdtree 23dfc6d81 continue breaking down the epic autoload module f982f61e8 continue breaking up the autoload/nerdtree god module 86488b1aa move ui functions out into their own autoload 04d9b2754 add `.refreshFlags()` to path/dir/file objects 3941389f1 fix a retarded bug with FlagSet.clearFlags 32cf3ee62 allow flags to be scoped to a plugin a7428eba3 add proof of concept for path flags API and add git modified flags 3effeb5cb Merge pull request #347 from kelaban/minor-fix-to-readme 04ac39b4b Fixes README for opening vim with no files d162c08fd comment and tweak the <LeftRelease> fix in 24561ad 2a769a726 Merge pull request #298 from buggo/master 0ee888ee1 simplify the <cr> mapping definition 0b551a8ab Merge pull request #346 from shanesmith/master 82cd4f5a9 Fix <CR> not working if active node map is special char such as <Right> b64942a50 uncomment out some needed syntax matching code... fail e954b2e6f trivial highlighting update for consistency e68e12a33 fix highlighting for readonly files b33d6daf0 remove the NERDChristmasTree option abb93879b simplify the syntax matching code slightly 634c23ead Merge branch 'better_symlink_highlighting' into update_highlighting 9d9edd03d separate out syntax matching for Dir Arrows vs old style 9704a38a1 update symlink highlighting 55a8954c4 update the doc/quickhelp for :Bookmark 0b1166ff7 update code in readme to auto-open a tree on startup b2d2cc184 Merge branch 'inkarkat-better-set-filetype' 4b89264df Merge branch 'better-set-filetype' of https://github.com/inkarkat/nerdtree into inkarkat-better-set-filetype 1168f5898 update the NERDTreeCascadeOpenSingleChildDir doc 0928b5b02 Merge pull request #251 from pendulm/master 8189597c0 Merge pull request #266 from staeff/patch-1 9e54c4808 Merge pull request #299 from tophsic/master 3863e6973 Merge pull request #316 from ZeroProbability/master 8b4841315 rename NERDTreeWildIgnore option and refactor the usage of it 186abb84c Merge pull request #303 from amarshall/wildignore 10ba84b1f Merge pull request #308 from igrep/patch-1 a45304832 Merge pull request #295 from DanielleSucher/create_parent_directories_as_needed dd8fe4bf6 Merge pull request #274 from an1zhegorodov/master e9427a9ca Merge pull request #326 from migueldvb/docs 23d2d1984 Merge pull request #331 from jinnko/add-bookmarks-sort-flag 1da289085 Merge pull request #338 from trkoch/spaces-umlauts 47a3a8410 Merge pull request #340 from netj/sort-hidden-first-option 43842e0de Option for mixing dot files when sorting fbab099fa Support space in path when renaming e38d8a834 Add flag to disable/enable bookmark sorting 603e6c74f Use pathogen.vim Helptags command in README file 13b4058f2 Issue 315 - Incorrect buffer deleted on file delete ad4ebaac9 correct invalid reference to MenuController a50c57192 Add option to respect wildignore 4f48af0cb Fix typo 24561ad59 Ugly hack to fix Error 121 when NERDTree is the active window and clicking on the command line below another window. eacd5d72e Create nested parent directories as needed 5b51f9d1b Fix help mistake 2ebe28468 Fixed typo in NERD_tree.txt 6ef67a2d8 Add correspoding close action to cascade open single child dir 60683f1cc Fix typo Casade to Cascade b8cab9bae Set filetype unconditionally and after defining mappings. git-subtree-dir: vim/bundle/nerdtree git-subtree-split: 4dada8c04fba25e788ea1836c82f9c18c1166b44 |
8 years ago | |
---|---|---|
autoload | 8 years ago | |
doc | 8 years ago | |
lib/nerdtree | 8 years ago | |
nerdtree_plugin | 8 years ago | |
plugin | 8 years ago | |
syntax | 8 years ago | |
.gitignore | 11 years ago | |
CHANGELOG | 8 years ago | |
LICENCE | 8 years ago | |
README.markdown | 8 years ago |
README.markdown
The NERD Tree
Intro
The NERD tree allows you to explore your filesystem and to open files and directories. It presents the filesystem to you in the form of a tree which you manipulate with the keyboard and/or mouse. It also allows you to perform simple filesystem operations.
The following features and functionality are provided by the NERD tree:
- Files and directories are displayed in a hierarchical tree structure
- Different highlighting is provided for the following types of nodes:
- files
- directories
- sym-links
- windows .lnk files
- read-only files
- executable files
- Many (customisable) mappings are provided to manipulate the tree:
- Mappings to open/close/explore directory nodes
- Mappings to open files in new/existing windows/tabs
- Mappings to change the current root of the tree
- Mappings to navigate around the tree
- ...
- Directories and files can be bookmarked.
- Most NERD tree navigation can also be done with the mouse
- Filtering of tree content (can be toggled at runtime)
- custom file filters to prevent e.g. vim backup files being displayed
- optional displaying of hidden files (. files)
- files can be "turned off" so that only directories are displayed
- The position and size of the NERD tree window can be customised
- The order in which the nodes in the tree are listed can be customised.
- A model of your filesystem is created/maintained as you explore it. This
has several advantages:
- All filesystem information is cached and is only re-read on demand
- If you revisit a part of the tree that you left earlier in your session, the directory nodes will be opened/closed as you left them
- The script remembers the cursor position and window position in the NERD tree so you can toggle it off (or just close the tree window) and then reopen it (with NERDTreeToggle) the NERD tree window will appear exactly as you left it
- You can have a separate NERD tree for each tab, share trees across tabs, or a mix of both.
- By default the script overrides the default file browser (netrw), so if you :edit a directory a (slightly modified) NERD tree will appear in the current window
- A programmable menu system is provided (simulates right clicking on a node)
- one default menu plugin is provided to perform basic filesystem operations (create/delete/move/copy files/directories)
- There's an API for adding your own keymappings
Installation
####pathogen.vim
cd ~/.vim/bundle
git clone https://github.com/scrooloose/nerdtree.git
Then reload vim, run :Helptags
, and check out :help NERD_tree.txt
.
####apt-vim
apt-vim install -y https://github.com/scrooloose/nerdtree.git
Faq
Is there any support for
git
flags?
Yes, install nerdtree-git-plugin.
Can I have the nerdtree on every tab automatically?
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
If you are interested in this behaviour then consider vim-nerdtree-tabs
How can I open a NERDTree automatically when vim starts up?
Stick this in your vimrc: autocmd vimenter * NERDTree
How can I open a NERDTree automatically when vim starts up if no files were specified?
Stick this in your vimrc
autocmd StdinReadPre * let s:std_in=1
autocmd VimEnter * if argc() == 0 && !exists("s:std_in") | NERDTree | endif
How can I map a specific key or shortcut to open NERDTree?
Stick this in your vimrc to open NERDTree with Ctrl+n
(you can set whatever key you want):
map <C-n> :NERDTreeToggle<CR>
How can I close vim if the only window left open is a NERDTree?
Stick this in your vimrc:
autocmd bufenter * if (winnr("$") == 1 && exists("b:NERDTreeType") && b:NERDTreeType == "primary") | q | endif
Can I have different highlighting for different file extensions?
See here: https://github.com/scrooloose/nerdtree/issues/433#issuecomment-92590696
How can I change default arrows?
Use these variables in your vimrc. Note that below are default arrow symbols
let g:NERDTreeDirArrows = 1
let g:NERDTreeDirArrowExpandable = '▸'
let g:NERDTreeDirArrowCollapsible = '▾'