| Author: | Michael Sanders |
|---|---|
| Maintainer: | Rok Garbas |
| Homepage: | http://www.vim.org/scripts/script.php?script_id=2540 |
| Contributors: | MarcWeber, lilydjwg, henrik, steveno, asymmetric, jherdman, ironcamel, honza, jb55, robhudson, kozo2, MicahElliott, darkwise, redpill, thisgeek, sickill, pose, marutanm, r00k, jbernard, holizz, muffinresearch, statik, Eustaquio Rangel, alderz, pielgrzym |
Contents
After several unsuccessful attempts of contacting Michael Sanders, no commits in last half year and long pull request line on github (none of pull requests were commented/replied/rejected) I decided to take action, step up and bring some love to this widely used plugin. But nothing to worry about. We all get busy, accupied with our daily work or just lose interest in doing boring maintainance. While reviewing pull requests on github.com/msanders I found lots of great improvements and I decided to **friendly** fork it, review and apply patches that were sent, notify all the patch submitters and decided to maintain snipmate.vim from now on. Of course if somebody wants to help, please do not hesitate to write me, I am open to any suggestions. Maybe I will only maintain it for a while until Michael Sanders takes things back into his hand or until some other super-hero shows up. Tnx and happy snipmating, Rok Garbas, 2011-02-02
Adding general snippets to
css.snippetsandhtmldjango.snippets[2011-06-10, pielgrzym]Adding
css.snippetsfrom tisho (https://github.com/tisho/css-snippets-snipmate) [2011-04-17, garbas]Lots of updates to snippets.
Made the trigger key configurable, garbas#4. [2011-04-13, thenoseman]
Handle single-line or multiline snippets. [2011-03-22, johnbintz]
If there is only one snippet choose it directly. [2011-03-16, blueyed]
Add snippets file for "diff" filetype and add bang to function definitons, allowing for reload. [2011-03-06, blueyed]
Update snipmate to handle latest supertab version. [2011-02-09, ervandew]
Updated README: added contributors, instructions how to install snipMate, some spellchecking of my wonderfull english, added this Changelog [2011-02-07, garbas]
Fixed bug: When leaving a placeholder unchanged and trying to jump to the next placeholder, the text of the first placeholder would get cleared. [2011-06-16, jgosmann]
From below mentioned merges I must specially mention MarcWeber's patch which brought quite a few functionalities/improvements:
- snippets are loaded lazily.
- snippets are no longer cached. Thus you always get the snippets you just wrote to a file without reloading anything.
- When visually selecting a snippet in a .snippets file you can press <cr> to replace spaces by tabs automatically in a smart way.
Big +1 to MarcWeber for this. Important to note is that we now depend on vim-addon-mw-utils and tlib. [2011-02-02, garbas]
Merged pull requests of MarcWeber, lilydjwg, henrik, steveno, asymmetric, jherdman, ironcamel, honza, jb55, robhudson, kozo2, MicahElliott, darkwise, redpill, thisgeek, sickill, pose, [2011-02-02, garbas]
- last release done by Michael Sanders, you can find it here:
- http://www.vim.org/scripts/download_script.php?src_id=11006
Unfortunatly there are many ways to how to install vim plugins. If you don't see you prefered way of installation plugins please consider adding updating this section.
- Important to note is that since version 1.0 we depend on this 2 vim plugins:
- vim-addon-mw-utils providing the implementation for caching parsed .snippets files.
- tlib for tlib#input#List which provides the excellent filterable list selection view (and more).
Using VAM
Add snipmate to the names to be installed. Or use "github:name/repo" if you want to use a non standard upstream. VAM will also fetch the dependencies listed above for you automatically.
Using pathogen
% cd ~/.vim % mkdir bundle % cd bundle % git clone git://github.com/garbas/vim-snipmate.git # Install dependencies: % git clone https://github.com/tomtom/tlib_vim.git % git clone https://github.com/MarcWeber/vim-addon-mw-utils.git
Using Vundle
Install dependencies: Bundle "git://github.com/MarcWeber/vim-addon-mw-utils.git" Bundle "git://github.com/tomtom/tlib_vim.git" Install: Bundle "git://github.com/garbas/snipmate.vim.git" And :BundleInstall
% git clone git://github.com/garbas/vim-snipmate.git % cd snipmate.vim % cp -R * ~/.vim
Then in vim:
:helptags ~/.vim/doc/
Then install any dependencies (see above).
See TODO / Future. We'd like to split snippets of the core in the long run. Probably there will be one snippet repo containing almost all snippets.
We also encourage people to maintain sets of snippets for particular use cases. That all users can benefit from them people can list their snippet repositories here:
- https://github.com/rbonvall/snipmate-snippets-bib (snippets for BibTeX files)
Installation using VAM: "github:rbonvall/snipmate-snippets-bib"
Notify all "forkers" about new home and ask them nicely to review already merged changes and possibly send their changes. [2011-02-07, garbas]
I'd like to investigate whether xptemplate or snipmate has the better engine. So maybe my vision of the future could be making xptemplate read snippet files. It is not important enough for me to work on it right now as snipmate works reasonable well for me. [2011-02-02, MarcWeber]
Split core from snippets. Then reviewing patches and updates will be easier? Snippets should be distributed in additional repositories. Eg snipmate-snippets-ruby snipmate-snippets-vim snipmate-snippets-.... One repo containing snippets is: git://github.com/scrooloose/snipmate-snippets.git
comment without verifying it: < Silex> MarcWeber: btw, check out ultisnips. Much better than snipmate imho
And before this discussion xptemplate vs snipmate vs ultisnips .. continues we should create a wiki page comparing them and keep that up to date. If you volunteer tell me so that I can reference the link. [2011-02-02, MarcWeber]