Difference between revisions of "Yasnippet"
Jump to navigation
Jump to search
m (formatting) |
m |
||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 7: | Line 7: | ||
}} | }} | ||
| − | '''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. | + | '''YASnippet''' (Yet Another Snippet) 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. |
== Basic setup == | == Basic setup == | ||
| Line 21: | Line 21: | ||
; {{Keys|Tab}} | ; {{Keys|Tab}} | ||
: Expand snippet. | : Expand snippet. | ||
| + | |||
| + | == Embedded Lisp == | ||
| + | It is possible to embed lisp code directly in to snippet files by surrounding the | ||
| + | s-expression with backticks ('''`'''). For example: | ||
| + | <syntaxhighlight lang="lisp"> | ||
| + | #name : document string | ||
| + | # -- | ||
| + | ------------------------------------------------------------------------------- | ||
| + | -- `(car (last (split-string (buffer-file-name) "/"))) ; finds last entry | ||
| + | ; (filename) in the full path of the file` | ||
| + | -- Author: Author | ||
| + | -- Description: $1 | ||
| + | ------------------------------------------------------------------------------- | ||
| + | </syntaxhighlight> | ||
| + | This snippet will extract the name of the buffer (which is presumably the file | ||
| + | name) and add it to the second line of the expansion. Yasnippet is smart enough | ||
| + | to ignore the comment at the end of the line as well. | ||
== Common Customization == | == Common Customization == | ||
| + | |||
| + | === Use Yasnippet with Hippie Expand === | ||
| + | |||
| + | If you use [[Hippie Expand]], you can add [[Yasnippet]] to the list of expansion functions. For example if you want to try expanding snippets first: | ||
| + | {{Snippet|(setq hippie-expand-try-functions-list (cons 'yas/hippie-try-expand hippie-expand-try-functions-list))}} | ||
| + | |||
| + | You could do this globally, or for a specific mode using a [[mode hook]]. | ||
| + | |||
| + | {{Note|If you use {{Keys|Tab}} for [[Hippie Expand]], consider using a prefix for your snippets. Otherwise you may be trying to tab between possible expansions and find yourself tabbing through fields in an expanded snippet instead.}} | ||
== See Also == | == See Also == | ||
| Line 32: | Line 58: | ||
* [http://yasnippet.googlecode.com/files/yas_demo.avi Screencast] | * [http://yasnippet.googlecode.com/files/yas_demo.avi Screencast] | ||
| − | [[Category:Convenience]][[Category:Third Party Package]] | + | [[Category:Intermediate]] |
| + | [[Category:Convenience]] | ||
| + | [[Category:Third Party Package]] | ||
| + | [[Category:Template System]] | ||
| + | [[Category:Editing]] | ||
| + | [[Category:Popular Package]] | ||
Latest revision as of 20:03, 18 October 2013
| Description | template system for Emacs |
|---|---|
| Author | João Távora |
| Maintainer | João Távora |
| Source | https://github.com/capitaomorte/yasnippet |
YASnippet (Yet Another Snippet) 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.
Basic setup
(add-to-list 'load-path "~/.emacs.d/plugins/yasnippet")
(require 'yasnippet)
(yas/global-mode 1)
Helpful keybindings
- [Tab]
- Expand snippet.
Embedded Lisp
It is possible to embed lisp code directly in to snippet files by surrounding the s-expression with backticks (`). For example:
#name : document string
# --
-------------------------------------------------------------------------------
-- `(car (last (split-string (buffer-file-name) "/"))) ; finds last entry
; (filename) in the full path of the file`
-- Author: Author
-- Description: $1
-------------------------------------------------------------------------------
This snippet will extract the name of the buffer (which is presumably the file name) and add it to the second line of the expansion. Yasnippet is smart enough to ignore the comment at the end of the line as well.
Common Customization
Use Yasnippet with Hippie Expand
If you use Hippie Expand, you can add Yasnippet to the list of expansion functions. For example if you want to try expanding snippets first:
(setq hippie-expand-try-functions-list (cons 'yas/hippie-try-expand hippie-expand-try-functions-list))
You could do this globally, or for a specific mode using a mode hook.
Note: If you use [Tab] for Hippie Expand, consider using a prefix for your snippets. Otherwise you may be trying to tab between possible expansions and find yourself tabbing through fields in an expanded snippet instead.