skeletons.vim icon indicating copy to clipboard operation
skeletons.vim copied to clipboard

VIM Skeletons plugin

============= VIM Skeletons

This tiny VIM Skeletons plugin allows you to define a skeleton file per file type, which is used whenever you create a new file of that type. Furthermore, it makes use of UltiSnips__ snippet engine to directly leave you with placeholder you can jump through and prefill with sensible defaults.

__ https://github.com/SirVer/ultisnips

Installation

For installation I recommend using Vundle__, a package manager for VIM plugins. If you have Vundle running, the following line in your .vimrc enables the plugin::

Bundle "tobyS/skeletons.vim"

__ https://github.com/gmarik/vundle

Now you run

::

:BundleInstall

and you're done.

If you prefer any other VIM plugin manager, you will find your way according to your preferences. If you do not use a VIM plugin manager, you should use one.

I ship an example skeleton for your pleasure. Take a look in the skeletons/ directory. Note, that this skeleton will not be used by Skeletons by default.

Usage

Using Skeletons is easy. Just install the plugin and put your skeleton files into

::

~/.vim/skeletons/

a skeleton file name must follow the simple format whatever.<ft> where <ft> is the file type you want to register the skeleton for. If you have mutliple files for one type, Skeletons will simply use one. Which one? No idea. Therefore I recommend to use skeleton.<ft> by convention to avoid this issue.

If you want to change the directory where skeletons are stored, take a look at Configuration_.

Configuration

You can influence the bahavior of Skeletons by two confiuguration variables:

g:skeletons_dir Set this variable to a different directory if you don't want to have your skeletons to be located in ~/.vim/skeletons/. g:skeletons_autoregister Set this to 1 in order to avoid Skeletons to auto-register its autocommand for inserting the skeletons. You need to do this action yourself then.

.. Local Variables: mode: rst fill-column: 79 End: vim: et syn=rst tw=79