mirror of
https://github.com/joaotavora/yasnippet.git
synced 2025-10-13 21:13:04 +00:00
Updated the introduction doc, thanks Xah Lee for contributing this description
This commit is contained in:
Zhang Chiyuan
parent
f4dd4094fd
commit
36455f570d
175
doc/index.html
175
doc/index.html
@ -43,142 +43,83 @@
|
|||||||
<div class="contents topic" id="contents">
|
<div class="contents topic" id="contents">
|
||||||
<p class="topic-title first">Contents</p>
|
<p class="topic-title first">Contents</p>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><a class="reference internal" href="#getting-started" id="id5">Getting Started</a><ul>
|
<li><a class="reference internal" href="#video-demo" id="id1">Video Demo</a></li>
|
||||||
<li><a class="reference internal" href="#for-the-busy-or-impatient-people" id="id6">For the busy or impatient people</a></li>
|
<li><a class="reference internal" href="#brief-install-instruction" id="id2">Brief Install Instruction</a><ul>
|
||||||
<li><a class="reference internal" href="#for-lazy-poeple-or-beginners" id="id7">For lazy poeple or beginners</a></li>
|
<li><a class="reference internal" href="#bundle-install" id="id3">Bundle Install</a></li>
|
||||||
<li><a class="reference internal" href="#for-you" id="id8">For you</a></li>
|
<li><a class="reference internal" href="#normal-install" id="id4">Normal Install</a></li>
|
||||||
<li><a class="reference internal" href="#for-geeks" id="id9">For geeks</a></li>
|
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a class="reference internal" href="#how-to-contribute" id="id10">How to contribute ?</a><ul>
|
<li><a class="reference internal" href="#bugs-contribution-and-support" id="id5">Bugs, Contribution and Support</a></li>
|
||||||
<li><a class="reference internal" href="#issues" id="id11">Issues</a></li>
|
|
||||||
<li><a class="reference internal" href="#suggestion-feature-request" id="id12">Suggestion, Feature Request</a></li>
|
|
||||||
<li><a class="reference internal" href="#snippets" id="id13">Snippets</a></li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><a class="reference internal" href="#detailed-documentation" id="id14">Detailed Documentation</a></li>
|
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<p>YASnippet is a re-design and re-write of my original extension
|
<p>Yasnippet is a template system for emacs. It allows you to type a
|
||||||
|
abbrevation and automatically expand the abbreviation into function
|
||||||
|
templates.</p>
|
||||||
|
<p>Bundled language templates includes: C, C++, C#, Perl, Python, Ruby,
|
||||||
|
SQL, LaTeX, HTML, CSS and more.</p>
|
||||||
|
<p>Yasnippet system is inspired from TextMate's template system. You can
|
||||||
|
use a tool to import any TextMate template you have to Yasnippet. It
|
||||||
|
is a re-design and re-write of my original extension
|
||||||
<a class="reference external" href="http://code.google.com/p/smart-snippet/">smart-snippet</a>. It is much cleaner and more powerful than
|
<a class="reference external" href="http://code.google.com/p/smart-snippet/">smart-snippet</a>. It is much cleaner and more powerful than
|
||||||
smart-snippet.</p>
|
smart-snippet.</p>
|
||||||
<div class="section" id="getting-started">
|
<div class="section" id="video-demo">
|
||||||
<h1><a class="toc-backref" href="#id5">Getting Started</a></h1>
|
<h1><a class="toc-backref" href="#id1">Video Demo</a></h1>
|
||||||
<div class="section" id="for-the-busy-or-impatient-people">
|
<p>Watch the <a class="reference external" href="http://www.youtube.com/watch?v=vOj7btx3ATg">demo at YouTube</a> (download a higher
|
||||||
<h2><a class="toc-backref" href="#id6">For the busy or impatient people</a></h2>
|
resolution version: <a class="reference external" href="http://yasnippet.googlecode.com/files/yasnippet.avi">yasnippet.avi</a>).</p>
|
||||||
<p>Watch the <a class="reference external" href="http://www.youtube.com/watch?v=vOj7btx3ATg">screencast at YouTube</a> or download <a class="reference external" href="http://yasnippet.googlecode.com/files/yasnippet.avi">the one
|
|
||||||
with a higher resolution</a>.</p>
|
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="for-lazy-poeple-or-beginners">
|
<div class="section" id="brief-install-instruction">
|
||||||
<h2><a class="toc-backref" href="#id7">For lazy poeple or beginners</a></h2>
|
<h1><a class="toc-backref" href="#id2">Brief Install Instruction</a></h1>
|
||||||
<ol class="arabic">
|
<p>There are two archives of YASnippet. One is a single file compiled
|
||||||
<li><p class="first">Download the latest bundle release <a class="footnote-reference" href="#id3" id="id1">[1]</a> from the <a class="reference external" href="http://code.google.com/p/yasnippet/downloads/list">downloads page</a>.</p>
|
“bundle”, and the other is normal. If all you need is to use the
|
||||||
</li>
|
builtin templates, download the bundle one. If you want to add your
|
||||||
<li><p class="first">Create a directory <tt class="docutils literal"><span class="pre">~/emacs/plugins</span></tt>.</p>
|
own templates, download the normal one.</p>
|
||||||
</li>
|
<div class="section" id="bundle-install">
|
||||||
<li><p class="first">Unpack the downloaded bundle to that directory.</p>
|
<h2><a class="toc-backref" href="#id3">Bundle Install</a></h2>
|
||||||
</li>
|
<ul class="simple">
|
||||||
<li><p class="first">Add the following code to your <tt class="docutils literal"><span class="pre">~/.emacs</span></tt> file:</p>
|
<li>Download the latest <tt class="docutils literal"><span class="pre">yasnippet-bundle-x.y.z.el.tgz</span></tt> and unpack it.</li>
|
||||||
|
<li>Open the file, and type <tt class="docutils literal"><span class="pre">Alt+x</span> <span class="pre">eval-buffer</span></tt>.</li>
|
||||||
|
</ul>
|
||||||
|
<p>That's it. Now open any one of your language file, you'll see a menu
|
||||||
|
YASnippet. you can pull the menu to insert a template. Or, you can
|
||||||
|
type the pre-defined abbrev and press <tt class="docutils literal"><span class="pre">TAB</span></tt> to expand it.</p>
|
||||||
|
<p>To have emacs load YASnippet automatically when it starts, put the
|
||||||
|
following in your <tt class="docutils literal"><span class="pre">.emacs</span></tt> file:</p>
|
||||||
|
<blockquote>
|
||||||
<div class="highlight"><pre>(<span style="color: #19177C">add-to-list</span> <span style="color: #19177C">'load-path</span>
|
<div class="highlight"><pre>(<span style="color: #19177C">add-to-list</span> <span style="color: #19177C">'load-path</span>
|
||||||
<span style="color: #BA2121">"~/emacs/plugins"</span>)
|
<span style="color: #BA2121">"/path/to/dir/containing/bundle/file"</span>)
|
||||||
(<span style="color: #008000">require</span> <span style="color: #19177C">'yasnippet-bundle</span>)
|
(<span style="color: #008000">require</span> <span style="color: #19177C">'yasnippet-bundle</span>)
|
||||||
</pre></div>
|
</pre></div>
|
||||||
</li>
|
</blockquote>
|
||||||
</ol>
|
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="for-you">
|
<div class="section" id="normal-install">
|
||||||
<h2><a class="toc-backref" href="#id8">For you</a></h2>
|
<h2><a class="toc-backref" href="#id4">Normal Install</a></h2>
|
||||||
<ol class="arabic">
|
<p>For full install of the normal archive, just download and unpack the
|
||||||
<li><p class="first">Download the latest YASnippet release package <a class="footnote-reference" href="#id4" id="id2">[2]</a> from the
|
latest <tt class="docutils literal"><span class="pre">yasnippet-x.y.z.tar.bz2</span></tt>, put it in your <tt class="docutils literal"><span class="pre">load-path</span></tt> and
|
||||||
<a class="reference external" href="http://code.google.com/p/yasnippet/downloads/list">downloads page</a>.</p>
|
add the following in your <tt class="docutils literal"><span class="pre">.emacs</span></tt> file:</p>
|
||||||
</li>
|
<blockquote>
|
||||||
<li><p class="first">Unpack it to a directory and add that directory to your
|
|
||||||
<tt class="docutils literal"><span class="pre">load-path</span></tt>.</p>
|
|
||||||
</li>
|
|
||||||
<li><p class="first">Add the following code to your <tt class="docutils literal"><span class="pre">~/.emacs</span></tt> file:</p>
|
|
||||||
<div class="highlight"><pre>(<span style="color: #008000">require</span> <span style="color: #19177C">'yasnippet</span>) <span style="color: #408080; font-style: italic">;; not yasnippet-bundle</span>
|
<div class="highlight"><pre>(<span style="color: #008000">require</span> <span style="color: #19177C">'yasnippet</span>) <span style="color: #408080; font-style: italic">;; not yasnippet-bundle</span>
|
||||||
(<span style="color: #19177C">yas/initialize</span>)
|
(<span style="color: #19177C">yas/initialize</span>)
|
||||||
(<span style="color: #19177C">yas/load-directory</span> <span style="color: #BA2121">"/path/to/the/snippets/directory/"</span>)
|
(<span style="color: #19177C">yas/load-directory</span> <span style="color: #BA2121">"/path/to/the/snippets/directory/"</span>)
|
||||||
</pre></div>
|
</pre></div>
|
||||||
</li>
|
</blockquote>
|
||||||
<li><p class="first">You can inspect into the <tt class="docutils literal"><span class="pre">snippets</span></tt> directory for adding your own
|
<p>Please refer to the documentation for full customization.</p>
|
||||||
snippets.</p>
|
|
||||||
</li>
|
|
||||||
<li><p class="first">Detailed document can be found at the <tt class="docutils literal"><span class="pre">doc</span></tt> directory.</p>
|
|
||||||
</li>
|
|
||||||
</ol>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="for-geeks">
|
|
||||||
<h2><a class="toc-backref" href="#id9">For geeks</a></h2>
|
|
||||||
<p>If you want to always follow the latest code. You can check out it
|
|
||||||
from the svn repository:</p>
|
|
||||||
<div class="highlight"><pre>svn checkout http://yasnippet.googlecode.com/svn/trunk/ yasnippet
|
|
||||||
</pre></div>
|
|
||||||
<p>However, I try to release a new version as soon as I made some changes
|
|
||||||
that will affect the normal use or added some new features. So there's
|
|
||||||
usually no need to follow the svn repository. Except that you might
|
|
||||||
find <tt class="docutils literal"><span class="pre">svn</span> <span class="pre">up</span></tt> is more convenient than downloading and unpacking the
|
|
||||||
release package. :D</p>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="how-to-contribute">
|
<div class="section" id="bugs-contribution-and-support">
|
||||||
<h1><a class="toc-backref" href="#id10">How to contribute ?</a></h1>
|
<h1><a class="toc-backref" href="#id5">Bugs, Contribution and Support</a></h1>
|
||||||
<p>If you like YASnippet, you can recommendate it to your friends.</p>
|
|
||||||
<div class="section" id="issues">
|
|
||||||
<h2><a class="toc-backref" href="#id11">Issues</a></h2>
|
|
||||||
<p>If you find a bug you can create a new issue at the <a class="reference external" href="http://code.google.com/p/yasnippet/issues/list">issue list</a>. Please describe
|
|
||||||
the problem as clear as possible.</p>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="suggestion-feature-request">
|
|
||||||
<h2><a class="toc-backref" href="#id12">Suggestion, Feature Request</a></h2>
|
|
||||||
<p>There's a <a class="reference external" href="http://groups.google.com/group/smart-snippet">discussion group</a> for both smart-snippet and yasnippet. If
|
|
||||||
you have any suggesion, you can post to there and discuss with other
|
|
||||||
members.</p>
|
|
||||||
<p>Especially, there's a <a class="reference external" href="http://code.google.com/p/yasnippet/wiki/WishList">wish list</a> wiki page. I'll collect ideas from
|
|
||||||
the <a class="reference external" href="http://groups.google.com/group/smart-snippet">discussion group</a> to the <a class="reference external" href="http://code.google.com/p/yasnippet/wiki/WishList">wish list</a>. So you might want to look
|
|
||||||
at the <a class="reference external" href="http://code.google.com/p/yasnippet/wiki/WishList">wish list</a> before you post something.</p>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="snippets">
|
|
||||||
<h2><a class="toc-backref" href="#id13">Snippets</a></h2>
|
|
||||||
<p>YASnippet comes with some default snippet definitions. However, they
|
|
||||||
are far from complete. So I'm calling users to share their
|
|
||||||
snippets. If you have some good snippet definitions, you can post them
|
|
||||||
to the <a class="reference external" href="http://groups.google.com/group/smart-snippet">discussion group</a>. You can specify the <tt class="docutils literal"><span class="pre">contributor</span></tt>
|
|
||||||
property of the snippet like:</p>
|
|
||||||
<div class="highlight"><pre>#contributor : pluskid <pluskid@gmail.com>
|
|
||||||
#name : __...__
|
|
||||||
# --
|
|
||||||
__${init}__
|
|
||||||
</pre></div>
|
|
||||||
<p>I'll incorporate (some of) them in the release if suitable. However,
|
|
||||||
if you have <em>many</em> snippets (especially when they need to be
|
|
||||||
maintained and updated constantly), it is not suitable to put them in
|
|
||||||
the YASnippet release package. A better way is to make your snippets
|
|
||||||
publicly available and tell me the URL. I'll try to keep a list of
|
|
||||||
them on the wiki page.</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="detailed-documentation">
|
|
||||||
<h1><a class="toc-backref" href="#id14">Detailed Documentation</a></h1>
|
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li>See <a class="reference external" href="define_snippet.html">this page</a> on how to define a snippet by
|
<li>If you find a bug, please report it at <a class="reference external" href="http://code.google.com/p/yasnippet/issues/list">Issue List</a>.</li>
|
||||||
yourself.</li>
|
<li>If you have problem using YASnippet, or have some new ideas, please
|
||||||
<li>Here's the <a class="reference external" href="faq.html">FAQ</a> page.</li>
|
post to the <a class="reference external" href="http://groups.google.com/group/smart-snippet">discussion group</a>. Especially, there's a <a class="reference external" href="http://code.google.com/p/yasnippet/wiki/WishList">wish list</a>
|
||||||
<li>Here's the <a class="reference external" href="changelog.html">ChangeLog</a>.</li>
|
wiki page. I'll collect ideas from the <a class="reference external" href="http://groups.google.com/group/smart-snippet">discussion group</a> to the
|
||||||
|
<a class="reference external" href="http://code.google.com/p/yasnippet/wiki/WishList">wish list</a>. So you might want to look at the <a class="reference external" href="http://code.google.com/p/yasnippet/wiki/WishList">wish list</a> before
|
||||||
|
you post something.</li>
|
||||||
|
<li>If you want to contribute some snippets, you can also post them to
|
||||||
|
the <a class="reference external" href="http://groups.google.com/group/smart-snippet">discussion group</a>. Some common snippets may be added to
|
||||||
|
YASnippet, while others will be collected at the
|
||||||
|
<a class="reference external" href="http://code.google.com/p/yasnippet/wiki/UserContributedSnippets">UserContributedSnippets wiki page</a>.</li>
|
||||||
</ul>
|
</ul>
|
||||||
<table class="docutils footnote" frame="void" id="id3" rules="none">
|
<p>Thank you very much for using YASnippet!</p>
|
||||||
<colgroup><col class="label" /><col /></colgroup>
|
|
||||||
<tbody valign="top">
|
|
||||||
<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>They usually named like <tt class="docutils literal"><span class="pre">yasnippet-bundle-x.y.z.el.tgz</span></tt> where
|
|
||||||
<tt class="docutils literal"><span class="pre">x.y.z</span></tt> is the version number.</td></tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<table class="docutils footnote" frame="void" id="id4" rules="none">
|
|
||||||
<colgroup><col class="label" /><col /></colgroup>
|
|
||||||
<tbody valign="top">
|
|
||||||
<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>They usually named like <tt class="docutils literal"><span class="pre">yasnippet.x.y.z.tar.bz2</span></tt>.</td></tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
156
doc/index.rst
156
doc/index.rst
@ -8,47 +8,63 @@ Yet Another Snippet extension
|
|||||||
|
|
||||||
.. contents::
|
.. contents::
|
||||||
|
|
||||||
YASnippet is a re-design and re-write of my original extension
|
Yasnippet is a template system for emacs. It allows you to type a
|
||||||
|
abbrevation and automatically expand the abbreviation into function
|
||||||
|
templates.
|
||||||
|
|
||||||
|
Bundled language templates includes: C, C++, C#, Perl, Python, Ruby,
|
||||||
|
SQL, LaTeX, HTML, CSS and more.
|
||||||
|
|
||||||
|
Yasnippet system is inspired from TextMate's template system. You can
|
||||||
|
use a tool to import any TextMate template you have to Yasnippet. It
|
||||||
|
is a re-design and re-write of my original extension
|
||||||
`smart-snippet`_. It is much cleaner and more powerful than
|
`smart-snippet`_. It is much cleaner and more powerful than
|
||||||
smart-snippet.
|
smart-snippet.
|
||||||
|
|
||||||
.. _smart-snippet: http://code.google.com/p/smart-snippet/
|
.. _smart-snippet: http://code.google.com/p/smart-snippet/
|
||||||
|
|
||||||
Getting Started
|
|
||||||
===============
|
|
||||||
|
|
||||||
For the busy or impatient people
|
Video Demo
|
||||||
--------------------------------
|
==========
|
||||||
|
|
||||||
Watch the `screencast at YouTube
|
Watch the `demo at YouTube
|
||||||
<http://www.youtube.com/watch?v=vOj7btx3ATg>`_ or download `the one
|
<http://www.youtube.com/watch?v=vOj7btx3ATg>`_ (download a higher
|
||||||
with a higher resolution
|
resolution version: `yasnippet.avi
|
||||||
<http://yasnippet.googlecode.com/files/yasnippet.avi>`_.
|
<http://yasnippet.googlecode.com/files/yasnippet.avi>`_).
|
||||||
|
|
||||||
For lazy poeple or beginners
|
Brief Install Instruction
|
||||||
----------------------------
|
=========================
|
||||||
|
|
||||||
.. _downloads page: http://code.google.com/p/yasnippet/downloads/list
|
There are two archives of YASnippet. One is a single file compiled
|
||||||
|
“bundle”, and the other is normal. If all you need is to use the
|
||||||
|
builtin templates, download the bundle one. If you want to add your
|
||||||
|
own templates, download the normal one.
|
||||||
|
|
||||||
|
Bundle Install
|
||||||
|
--------------
|
||||||
|
|
||||||
|
* Download the latest ``yasnippet-bundle-x.y.z.el.tgz`` and unpack it.
|
||||||
|
* Open the file, and type ``Alt+x eval-buffer``.
|
||||||
|
|
||||||
|
That's it. Now open any one of your language file, you'll see a menu
|
||||||
|
YASnippet. you can pull the menu to insert a template. Or, you can
|
||||||
|
type the 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:
|
||||||
|
|
||||||
1. Download the latest bundle release [1]_ from the `downloads page`_.
|
|
||||||
2. Create a directory ``~/emacs/plugins``.
|
|
||||||
3. Unpack the downloaded bundle to that directory.
|
|
||||||
4. Add the following code to your ``~/.emacs`` file:
|
|
||||||
|
|
||||||
.. sourcecode:: common-lisp
|
.. sourcecode:: common-lisp
|
||||||
|
|
||||||
(add-to-list 'load-path
|
(add-to-list 'load-path
|
||||||
"~/emacs/plugins")
|
"/path/to/dir/containing/bundle/file")
|
||||||
(require 'yasnippet-bundle)
|
(require 'yasnippet-bundle)
|
||||||
|
|
||||||
For you
|
Normal Install
|
||||||
-------
|
--------------
|
||||||
|
|
||||||
1. Download the latest YASnippet release package [2]_ from the
|
For full install of the normal archive, just download and unpack the
|
||||||
`downloads page`_.
|
latest ``yasnippet-x.y.z.tar.bz2``, put it in your ``load-path`` and
|
||||||
2. Unpack it to a directory and add that directory to your
|
add the following in your ``.emacs`` file:
|
||||||
``load-path``.
|
|
||||||
3. Add the following code to your ``~/.emacs`` file:
|
|
||||||
|
|
||||||
.. sourcecode:: common-lisp
|
.. sourcecode:: common-lisp
|
||||||
|
|
||||||
@ -56,83 +72,25 @@ For you
|
|||||||
(yas/initialize)
|
(yas/initialize)
|
||||||
(yas/load-directory "/path/to/the/snippets/directory/")
|
(yas/load-directory "/path/to/the/snippets/directory/")
|
||||||
|
|
||||||
4. You can inspect into the ``snippets`` directory for adding your own
|
Please refer to the documentation for full customization.
|
||||||
snippets.
|
|
||||||
5. Detailed document can be found at the ``doc`` directory.
|
|
||||||
|
|
||||||
For geeks
|
Bugs, Contribution and Support
|
||||||
---------
|
==============================
|
||||||
|
|
||||||
If you want to always follow the latest code. You can check out it
|
* If you find a bug, please report it at `Issue List
|
||||||
from the svn repository:
|
<http://code.google.com/p/yasnippet/issues/list>`_.
|
||||||
|
* If you have problem using YASnippet, or have some new ideas, please
|
||||||
.. sourcecode:: bash
|
post to the `discussion group`_. Especially, there's a `wish list`_
|
||||||
|
wiki page. I'll collect ideas from the `discussion group`_ to the
|
||||||
svn checkout http://yasnippet.googlecode.com/svn/trunk/ yasnippet
|
`wish list`_. So you might want to look at the `wish list`_ before
|
||||||
|
you post something.
|
||||||
However, I try to release a new version as soon as I made some changes
|
* If you want to contribute some snippets, you can also post them to
|
||||||
that will affect the normal use or added some new features. So there's
|
the `discussion group`_. Some common snippets may be added to
|
||||||
usually no need to follow the svn repository. Except that you might
|
YASnippet, while others will be collected at the
|
||||||
find ``svn up`` is more convenient than downloading and unpacking the
|
`UserContributedSnippets wiki page
|
||||||
release package. :D
|
<http://code.google.com/p/yasnippet/wiki/UserContributedSnippets>`_.
|
||||||
|
|
||||||
How to contribute ?
|
|
||||||
===================
|
|
||||||
|
|
||||||
If you like YASnippet, you can recommendate it to your friends.
|
|
||||||
|
|
||||||
Issues
|
|
||||||
------
|
|
||||||
|
|
||||||
If you find a bug you can create a new issue at the `issue list
|
|
||||||
<http://code.google.com/p/yasnippet/issues/list>`_. Please describe
|
|
||||||
the problem as clear as possible.
|
|
||||||
|
|
||||||
Suggestion, Feature Request
|
|
||||||
---------------------------
|
|
||||||
|
|
||||||
There's a `discussion group`_ for both smart-snippet and yasnippet. If
|
|
||||||
you have any suggesion, you can post to there and discuss with other
|
|
||||||
members.
|
|
||||||
|
|
||||||
Especially, there's a `wish list`_ wiki page. I'll collect ideas from
|
|
||||||
the `discussion group`_ to the `wish list`_. So you might want to look
|
|
||||||
at the `wish list`_ before you post something.
|
|
||||||
|
|
||||||
Snippets
|
|
||||||
--------
|
|
||||||
|
|
||||||
YASnippet comes with some default snippet definitions. However, they
|
|
||||||
are far from complete. So I'm calling users to share their
|
|
||||||
snippets. If you have some good snippet definitions, you can post them
|
|
||||||
to the `discussion group`_. You can specify the ``contributor``
|
|
||||||
property of the snippet like:
|
|
||||||
|
|
||||||
.. sourcecode:: text
|
|
||||||
|
|
||||||
#contributor : pluskid <pluskid@gmail.com>
|
|
||||||
#name : __...__
|
|
||||||
# --
|
|
||||||
__${init}__
|
|
||||||
|
|
||||||
I'll incorporate (some of) them in the release if suitable. However,
|
|
||||||
if you have *many* snippets (especially when they need to be
|
|
||||||
maintained and updated constantly), it is not suitable to put them in
|
|
||||||
the YASnippet release package. A better way is to make your snippets
|
|
||||||
publicly available and tell me the URL. I'll try to keep a list of
|
|
||||||
them on the wiki page.
|
|
||||||
|
|
||||||
.. _discussion group: http://groups.google.com/group/smart-snippet
|
.. _discussion group: http://groups.google.com/group/smart-snippet
|
||||||
.. _wish list: http://code.google.com/p/yasnippet/wiki/WishList
|
.. _wish list: http://code.google.com/p/yasnippet/wiki/WishList
|
||||||
|
|
||||||
Detailed Documentation
|
Thank you very much for using YASnippet!
|
||||||
======================
|
|
||||||
|
|
||||||
* See `this page <define_snippet.html>`_ on how to define a snippet by
|
|
||||||
yourself.
|
|
||||||
* Here's the `FAQ <faq.html>`_ page.
|
|
||||||
* Here's the `ChangeLog <changelog.html>`_.
|
|
||||||
|
|
||||||
.. [1] They usually named like ``yasnippet-bundle-x.y.z.el.tgz`` where
|
|
||||||
``x.y.z`` is the version number.
|
|
||||||
.. [2] They usually named like ``yasnippet.x.y.z.tar.bz2``.
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user