Go to file
Shougo 370f7cdae5 Merge pull request #197 from LeafCage/fix_folding_marker_snip
fix: folding markerが含まれるsnippetで他の窓のfoldingが閉じられる問題
2013-12-12 01:52:16 -08:00
autoload fix: folding markerが含まれるsnippetで他の窓のfoldingが閉じられる問題 2013-12-12 08:31:10 +09:00
doc - Improved clear mappings. 2013-11-19 16:07:04 +09:00
ftdetect - Added ftdetect file. 2012-05-17 22:16:04 +09:00
ftplugin Changed behavior of b:undo_ftplugin 2013-09-25 14:36:37 +09:00
indent Changed behavior of b:undo_ftplugin 2013-09-25 14:36:37 +09:00
plugin Split view functions 2013-11-21 18:54:04 +09:00
syntax Fixed typing error 2013-04-12 17:13:38 +09:00
.gitignore Add .gitignore to ignore doc/tag. 2012-05-05 23:28:47 +08:00
README.md - Updated README. 2013-11-12 17:19:02 +09:00

Neosnippet

The Neosnippet plug-In adds snippet support to Vim. Snippets are small templates for commonly used code that you can fill in on the fly. To use snippets can increase your productivity in Vim a lot. The functionality of this plug-in is quite similar to plug-ins like snipMate.vim or snippetsEmu.vim. But since you can choose snippets with the neocomplcache / neocomplete interface, you might have less trouble using them, because you do not have to remember each snippet name.

Note: neocomplcache/neocomplete is NOT required! But recommended.

Extra snippets files are available in: vim-snippets

Installation

To install neosnippet and other Vim plug-ins it is recommended to use one of the popular package managers for Vim, rather than installing by drag and drop all required files into your .vim folder.

  1. Install the neocomplcache/ neocomplete plugin first.
  2. Put files in your Vim directory (usually ~/.vim/ or %PROGRAMFILES%/Vim/vimfiles on Windows).

Vundle

  1. Setup the vundle package manager

  2. Set the bundles for Neocomplcache or neocomplete And Neosnippet

    Bundle 'Shougo/neocomplcache'
    or
    Bundle 'Shougo/neocomplete'
    
    Bundle 'Shougo/neosnippet'
    
  3. Open up Vim and start installation with :BundleInstall

Neobundle

  1. Setup the neobundle package manager

  2. Set the bundles for Neocomplcache or neocomplete And Neosnippet

    NeoBundle 'Shougo/neocomplcache'
    or
    NeoBundle 'Shougo/neocomplete'
    
    NeoBundle 'Shougo/neosnippet'
    
  3. Open up Vim and start installation with :NeoBundleInstall

VAM (vim-addon-manager)

  1. Setup the vim-addon-manager package manager.

  2. Add neosnippet to the list of addons in your vimrc:

    call vam#ActivateAddons(['neosnippet'])
    

    . Installation will start automatically when you open vim next time.

Configuration

This is an example ~/.vimrc configuration for Neosnippet. It is assumes you already have Neocomplcache configured. With the settings of the example, you can use the following keys:

  • C-k to select-and-expand a snippet from the Neocomplcache popup (Use C-n and C-p to select it). C-k can also be used to jump to the next field in the snippet.
  • Tab to select the next field to fill in the snippet.
" Plugin key-mappings.
imap <C-k>     <Plug>(neosnippet_expand_or_jump)
smap <C-k>     <Plug>(neosnippet_expand_or_jump)
xmap <C-k>     <Plug>(neosnippet_expand_target)

" SuperTab like snippets behavior.
imap <expr><TAB> neosnippet#expandable_or_jumpable() ?
\ "\<Plug>(neosnippet_expand_or_jump)"
\: pumvisible() ? "\<C-n>" : "\<TAB>"
smap <expr><TAB> neosnippet#expandable_or_jumpable() ?
\ "\<Plug>(neosnippet_expand_or_jump)"
\: "\<TAB>"

" For snippet_complete marker.
if has('conceal')
  set conceallevel=2 concealcursor=i
endif

If you want to use a different collection of snippets than the built-in ones, then you can set a path to the snippets with the g:neosnippet#snippets_directory variable (e.g Honza's Snippets)

But if you enable g:neosnippet#enable_snipmate_compatibility, neosnippet will load snipMate snippets from runtime path automatically.

" Enable snipMate compatibility feature.
let g:neosnippet#enable_snipmate_compatibility = 1

" Tell Neosnippet about the other snippets
let g:neosnippet#snippets_directory='~/.vim/bundle/vim-snippets/snippets'