mirror of
https://github.com/joaotavora/yasnippet.git
synced 2025-10-13 21:13:04 +00:00
76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
# Intro
|
|
|
|
**YASnippet** is a template system for Emacs. It allows you to type an
|
|
abbreviation and automatically expand it into function
|
|
templates. Bundled language templates includes: C, C++, C#, Perl,
|
|
Python, Ruby,
|
|
|
|
SQL, LaTeX, HTML, CSS and more. The snippet syntax is inspired from
|
|
[TextMate's][textmate-snippets] syntax, you can even
|
|
[import][import-docs] most TextMate templates to YASnippet. Watch
|
|
[a demo on YouTube][youtube-demo] or download a
|
|
[higher resolution version][high-res-demo]
|
|
|
|
[textmate-snippets]: http://manual.macromates.com/en/snippets
|
|
[import-docs]: http://yasnippet.googlecode.com/svn/trunk/doc/snippet-development.html#importing-textmate-snippets
|
|
[youtube-demo]: http://www.youtube.com/watch?v=76Ygeg9miao
|
|
[high-res-demo]: http://yasnippet.googlecode.com/files/yas_demo.avi
|
|
|
|
# Install with yasnippet-bundle.el
|
|
|
|
To quickly tryout YASnippet, download the simpler "bundle" version.
|
|
If you plan to modify the bundled templates and/or build your own,
|
|
download the "normal" package.
|
|
|
|
* Download `yasnippet-bundle` from the downloads section.
|
|
|
|
* You'll get a file named `yasnippet-bundle.el`, put it in
|
|
`~/.emacs.d/plugins/` (create that directory if not exists).
|
|
|
|
* Open the file in Emacs, and type `M-x eval-buffer RET`.
|
|
|
|
That's it. Now open any file, you'll see a menu "YASnippet". You can
|
|
pull down the menu to insert a template. Or, you can type a
|
|
pre-defined abbrev and press TAB to expand it!
|
|
|
|
To have Emacs load YASnippet automatically when it starts, put the
|
|
following in your ~/.emacs file:
|
|
|
|
(add-to-list 'load-path
|
|
"~/.emacs.d/plugins")
|
|
(require 'yasnippet-bundle)
|
|
|
|
|
|
# Install
|
|
|
|
To install the normal archive, download and unpack the latest
|
|
`yasnippet-x.y.z.tar.bz2`. You'll get a directory named
|
|
`yasnippet-x.y.z`, put it in some `~/.emacs.d/plugins` dir and add the
|
|
following in your `.emacs` file:
|
|
|
|
(add-to-list 'load-path
|
|
"~/.emacs.d/plugins/yasnippet-x.y.z")
|
|
(require 'yasnippet) ;; not yasnippet-bundle
|
|
(yas/initialize)
|
|
(yas/load-directory "~/.emacs.d/plugins/yasnippet-x.y.z/snippets")
|
|
|
|
|
|
# How-tos, Bugs, Contributions...
|
|
|
|
Please refer to the comprehensive [documentation] [docs] for full
|
|
customization and support.
|
|
<!-- If you find a bug, please report it on -->
|
|
<!-- [the GitHub issue tracker][issues]. (please **do not** the deprecated -->
|
|
<!-- [googlecode tracker][googlecode tracker]) -->
|
|
|
|
If you run into problems using YASnippet, or have snippets to contribute, post
|
|
to the [yasnippet google group][forum]. Thank you very much for using YASnippet!
|
|
|
|
[docs]: http://yasnippet.googlecode.com/svn/trunk/doc/index.html
|
|
[issues]: https://github.com/capitaomorte/yasnippet/issues
|
|
[googlecode tracker]: http://code.google.com/p/yasnippet/issues/list
|
|
[forum]: http://groups.google.com/group/smart-snippet
|
|
|
|
|
|
|