---

Ⅰ. 插件描述

A .vimentry file parser.

Ⅱ. 基本信息

创建日期：  2014-03-17 使用用户：  7 Github星：  1 插件作者：  exvim

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'exvim/ex-vimentry'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'exvim/ex-vimentry'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'exvim/ex-vimentry'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/exvim/ex-vimentry

Ⅳ. 文档说明

# Intro

ex-vimentry is the vimentry file parser. When you open the file with suffix
.exvim, .vimentry or .vimproject, ex-vimentry will automatically parse
the content in it, and apply the settings once Vim started.

More details, check :help vimentry.

Requirements

• Vim 7.0 or higher.
• exvim/ex-utility

Installation

ex-vimentry is written based on exvim/ex-utility. This
is the basic library of ex-vim-plugins. Follow the readme file in ex-utility
and install it first.

ex-vimentry follows the standard runtime path structure, and as such it can
be installed with a variety of plugin managers:

To install using Vundle:

# add this line to your .vimrc file
Bundle 'exvim/ex-vimentry'

To install using Pathogen:

cd ~/.vim/bundle
git clone https://github.com/exvim/ex-vimentry

To install using NeoBundle:

# add this line to your .vimrc file
NeoBundle 'exvim/ex-vimentry'

Download zip file:

cd ~/.vim
unzip ex-vimentry-master.zip
copy all of the files into your ~/.vim directory

Syntax

vimentry file allow three type of values:

• option
• string
• array

Option

name = option_value

An option value will become string in vimscript, option doesn't allow white-space in it.

String

name = 'A string value'

A string is almost same as option value, except that it allow white-space in it.

Array

name = opt1,opt2,opt3
name += opt4
name += opt5,opt6

All of three lines above is operating the same array. Array element is separated by ,.
You can use += to continue operate an existed array.

NOTE: If you only have one item for an array, you must use += define it, otherwise
the value will become an option or a string. For example:

name += opt1

Add your event listeners

You can add event listeners after vimentry file parsed. To do this, you need to add register
scripts in your .vimrc file. ex-vimentry provide vimentry#on( event, funcref ) function
to help you do this.

There are three different events you can listen to: reset, changed and project_type_changed.

• reset: Before vimentry file apply changed settings.
• changed: When vimentry file changed, and saved by user.
• project_type_changed: After project_type changed.

NOTE:

Get vimentry settings.

In last section I show you the way to hook functions for vimentry events. ex-vimentry also
provide another function for get values you defined in vimentry file.

vimentry#get( name, ... )

Get value by {name}. You can provide default value in the second parameter, in case of the value
doesn't exists.

vimentry#check( name, val )

Check if the {name} of the value you defined is same as the {val}

Example

Here is a simple example to show you how to use vimentry file settings:

function my_func ()
    let project_name = vimentry#get('project_name')
    if project_name == ''
        call ex#error("Can't find vimentry setting 'project_name'.")
        return
    endif
endfunction

vimentry#on( 'changed', function('my_func') )