From 1ef6348ddbc6afcfe99ee4600e8d00b53710bd8c Mon Sep 17 00:00:00 2001 From: mattn Date: Thu, 27 Oct 2011 20:19:21 +0900 Subject: add document. --- doc/template-vim.txt | 154 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 154 insertions(+) create mode 100644 doc/template-vim.txt (limited to 'doc') diff --git a/doc/template-vim.txt b/doc/template-vim.txt new file mode 100644 index 0000000..4e75628 --- /dev/null +++ b/doc/template-vim.txt @@ -0,0 +1,154 @@ +*template.txt* Template for Vim + + ------------------------------------------------------- + Template: easy way coding + ------------------------------------------------------- + +Author: Yasuhiro Matsumoto +WebSite: http://mattn.kaoriya.net/ +Repository: http://github.com/mattn/template-vim +Site: http://mattn.github.com/template-vim +License: BSD style license + +============================================================================== +CONTENTS *template-contents* + +Introduction |template-introduction| +Install |template-install| +Tutorial |template-tutorial| +Customize |template-customize| +Write Your Template |template-writetemplate| + +============================================================================== +INTRODUCTION *template-introduction* *template* + +|Template| is easy way to coding. + + * Choose template for the filetype + * Few typings. + * Flexible customization. + +============================================================================== +INSTALL *template-install* + +Install the distributed files into Vim runtime directory which is usually +~/.vim/, or $HOME/vimfiles on Windows. + +If you install pathogen that provided from Tim Pope, you should extract the +file into 'bundle' directory. + +============================================================================== +TUTORIAL *template-tutorial* + +For example, you are writing C++ file. + +1. Create main function + + Open new C++ file, and type following. +> + :Template boost-main +< + Then you can see following. +> + #include + #include + #include + + int + main(int argc, char* argv[]) { + _ + return 0; + } +< + The cursor is in the position of |_|. + +2. Add foreach loop + + Type following. +> + :Template boost-for +< + Then you will be asked like following. +> + variable: +< + Then type "foo". +> + #include + #include + #include + + int + main(int argc, char* argv[]) { + BOOST_FOREACH(auto x, foo) { + _ + } + return 0; + } +< +3. Add std::cout << xxx << std::endl; +> + :Template cout +< + Answer "x" for the question "string:". +> + #include + #include + #include + + int + main(int argc, char* argv[]) { + BOOST_FOREACH(auto x, foo) { + std::cout << x << std::endl; + } + return 0; + } +< +============================================================================== +CUSTOMIZE *template-customize* + +You can modify template directory for your-self templates. +> + let g:template_vim_template_dir = '/path/to/your/template/directory' +< +============================================================================== +WRITE YOUR TEMPLATE *template-writetemplate* + +Templates are stored in the directory that "g:template_vim_template_dir" +variable specified. On unix, directory structure is following. +Note that I'm using pathogen-vim. +> + ~/.vim/bundle/template-vim + plugin + template.vim + doc + template.txt + template + main.go + package.go + package.perl + script.perl + ... +< +Template can have some keywords. + +|{{_name_}}| the filename without extension. + + If you are opening "foo.pl" for perl, {{_name_}} become "foo". + +|{{_cursor_}}| : cursor position. + + When expanded template, cursor will be moved to there. + +|{{_input_:var}}| : ask the value of "var". + + When expanded template, cursor will be moved to there. + +|{{_expr_:xxx}}| : expression in vimscript. + + For example, "Current Time:|{{_expr_:strftime('%c')}}|" will be +> + Current Time: 2011/10/27 20:19:00 +< +============================================================================== +vim:tw=78:ts=8:ft=help:norl:noet:fen:fdl=0: -- cgit v1.2.3-54-g00ecf