Go to file

Michael Thessel 8ec2e4ce7a Added array_walk snippet		2013-04-12 02:57:14 +00:00
snippets	Added array_walk snippet	2013-04-12 02:57:14 +00:00
UltiSnips	Fix issues in eruby.snippets	2013-04-16 14:08:14 +08:00
addon-info.json	drop dependency snipmate, cause there are two engines which can use this pool of snippets now	2012-12-07 09:55:53 +01:00
AUTHORS	Adding UltiSnips snippets, updating Readme	2013-03-17 20:13:47 +01:00
LICENSE	Add README, LICENSE and AUTHORS.	2011-06-20 19:49:54 -03:00
README.md	actually moving the repository list	2013-04-04 04:59:04 +02:00

README.md

IMPORTANT: comment on: What about merging whith Ultisnip using its engine

Snipmate & UltiSnip Snippets

This repository contains snippets files for various programming languages.

It is community-maintained and many people have contributed snippet files and other improvements already.

snippets/*: snippets using snipmate format
UltiSnips/*: snippets using UltiSnips format

Snippet engines

There are different forks of snippet engines which allow the user to insert sippets by typing the name of a snippet hitting the expansion mapping.

garbas/vim-snipmate [4]:
  VimL, snipmate-snippets, engine sometimes behaves strange, supports
  rewriting snippets on the fly (eg adding a second version with folding
  markers)

MarcWeber/UltiSnips [6]:
  python, snipmate-snippets and UltiSnips-snippets

SirVer/ultisnips [7]:
  python, UltiSnips-snippets

github.com/Shougo/neosnippet [5]:
  viml, has a compatible mode allowing to reuse most snipmate snippets ?

XPTemplate:
  totally different syntax, does not read snippets contained in this file,
  but it is also very powerful

... there are some more, but they have less features which is why I don't
mention them here

UltiSnips engine has additional features such as "nested snippets".

Which one to use? If you have python give MarcWeber/UltiSnips a try because its fast and supports all important features. You can prefer the UltiSnip versions of the snippets by setting the "always_use_first_snippet" option to 1.

If you have VimL only (vim without python support) your best option is using garbas/vim-snipmate and cope with the minor bugs found in the engine.

We also encourage people to maintain sets of snippets for particular use cases so 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)
 * https://github.com/sudar/vim-arduino-snippets (snippets for Arduino files)
 * https://github.com/zedr/zope-snipmate-bundle.git (snippets for Python, TAL and ZCML)
 * https://github.com/bonsaiben/bootstrap-snippets (snippets for Twitter Bootstrap markup, in HTML and Haml)

Installation using VAM: "github:rbonvall/snipmate-snippets-bib"

Historical notes

vim-snipmate was originally started by Michael Sanders who has now unfortunately abandoned the project. Rok Garbas is now maintaining a fork of the project in hopes of improving the existing code base.

Language maintainers

No one can really be proficient in all programming languages. If you would like to maintain snippets for a language, please get in touch.

Python - honza
Javascript - honza
HTML Django - honza
Markdown - honza
Ruby - taq
PHP - chrisyue

Contributing notes

Until further work is done on vim-snipmate, please don't add folding markers into snippets. vim-snipmate has some comments about how to patch all snippets on the fly adding those.

Because MarcWeber/UltiSnips 6 supports also snipmate-snippets there is no need to duplicate all snippets - only those snippets who use advanced UltiSnips features should be duplicated in UltiSnips (?)

Currently all snippets from UltiSnips have been put into UltiSnips - some work on merging should be done (dropping duplicates etc)

Authors

For a list of authors, please see the AUTHORS files.

License

Just as the original snipMate plugin, all the snippets are licensed under the terms of the MIT license.