---

Ⅰ. 插件描述

Vim plugin with support for Grunt

Ⅱ. 基本信息

创建日期：  2012-05-02 使用用户：  65 Github星：  41 插件作者：  Mickael Daniel

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'mklabs/grunt-vim'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'mklabs/grunt-vim'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'mklabs/grunt-vim'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/mklabs/grunt.vim

Ⅳ. 文档说明

grunt.vim

A lightweight wrapper to Grunt, so that you could grunt things directly from Vim

This plugin tries to detect a valid Gruntfile
({grunt|Gruntfile}.{js|coffee}), in the current working directory. If
it does, it defines a handy set of commands to work with grunt test or
lint task, to browse one of grunt documentation page and significantly
ease navigation of the Grunt directory structure.

There are a lot more features I'd like to see implemented or further improved,
but it's already been quite useful to me. Features:

• Interface to grunt. Use :Grunt to run the given task(s), really
  similar to directly running :!grunt --no-color <task, ...>.
• Grunt documentation as vim helpfile. Run :Helptags in the plugin
  directory and you'll get a bunch of :help grunt-* available. These

doc/*.txt helpfiles are generated automatically from markdown files
in grunt repository.

• Easy navigation of the Grunt directory structure. gf and :find
  know about task and test files. The path has been modified to

include current directory, tasks/, and bin/. For more advanced
usage, :Gtask, :Gtest commands are provided.

• :Gtask [{name}] Edit the specified task (in
  tasks/{name}.{js|coffee}}) or load a predefined template in current

  1. :Gtask <tab> works too.
• :Gtest {name} Edit the specified test or load a predefined template
  in current buffer. :Gtest <tab> works too.
• Integration with [quickfix
  window](http://vimdoc.sourceforge.net/htmldoc/quickfix.html#quickfix-window)

for displaying errors in grunt test or lint task.

• :Glint runs grunt lint and collects output for quickfix window
  display.
• :Gtest without arguments acts pretty much like :Glint.
• :Gdoc is a simple and handy command to open a web browser
  to one of the Grunt docuementation page on github. Just like, :Gtest

or :Gtask, a limited amount of completion is supported.

Installation

Using pathogen.vim is the best way to
install this plugin. Actually, some of pathogen function helpers are
used internally, so pathogen might very well be considered as one of
grunt.vim dependency.

cd ~/.vim/bundle
git clone git://github.com/mklabs/grunt.vim.git

Once help tags have been generated (either manually with :helptags or
via pathogen's :Helptags which might very well be directly put in your
.vimrc) you can view the manual with :help grunt.

This plugin also assumes both node and grunt are installed and available in
your $PATH, but that sounds reasonable for a Vim Grunt plugin.

quickfix

grunt.vim will automatically display errors in the quickfix window.

See :h quickfix

In the quickfix window, each line is one error. The line number is equal to
the error number. You can use ":.cc" to jump to the error under the cursor.
Hitting the <Enter> key or double-clicking the mouse on a line has the same

1. The file containing the error is opened in the window above the
2. 1. If there already is a window for that file, it is used

Once an error is fixed the corresponding quickfix line will disappear.
This works either way, the quickfix window is updated on file save,
whenever :Gtest or :Glint commands detect error output.

Configuration

Pretty minimal. No configuration hooks for now (except from
g:loaded_grunt that if set to 1 in your .vimrc will prevent the
plugin from being loaded)

A few notes

This plugin cares about the current working directory. Open Vim from
within a directory with a valid Gruntfile (grunt.js, grunt.coffee,
Gruntfile.js or Gruntfile.coffee)

The only command always available is :Grunt.

License & Acknowledgement

A lot of the codebase is either directly inspired, or extracted from Tim
pope's most excellent vim-rails
plugin.

Similarly, pathogen#glob function is the main handler of the few
completion function grunt.vim provides.

Also, the handy
parsejson#ParseJSON
utility is used and included in autoload/, as a library script.

License: Same as the three plugins mentioned above, same as Vim. See
:help license.