yasnippet-snippets/README.md

# Yasnippet official snippet collections
This repository contains the official snippets for [yasnippet](http://github.com/capitaomorte/yasnippet), as you can see from the git submodules link.

# How to install

There are two options, if you have checked out *yasnippet* already, the only thing you need to do is to run *git submodule update --init*
and it will checkout automatically this repository, at the last version it was synchronized too.

Otherwise if you want the latest and greatest snippets collection proceed as follows:

1. clone this repository
2. add to your .emacs the following
   - (add-to-list 'yas/root-directory "$DIRECTORY_WHERE_YOU_CLONED")
   - (yas/initialize)

3. M-x yas/reload-all to activate them

# Contributing

This repository has now become the default snippets repository (as a submodule) in yasnippet.
So if you have any useful snippets for any language or framework please feel free to contribute.

To study the current snippets I suggest to use M-x yas/describe-tables
which will gave a table representation of all the snippets available in the current mode.


# Guidelines

Snippets need to be generic enough to be useful for everyone, and not contain anything specific to your own system.

# Various notes

## HTML snippets

Until September 1st 2014 there were a lot of HTML snippets in the repository, which were sometimes useful but I came to the conclusion that yasnippet was not the right fool for them, so they were removed in this pull request:
https://github.com/AndreaCrotti/yasnippet-snippets/pull/49

To everyone writing a lot of HTML I suggest using [emmet mode](https://github.com/smihica/emmet-mode) instead, which is a much more powerful mode for writing HTML tags.