---

Ⅰ. 插件描述

vim-based archiver: builds, extracts, and previews

Ⅱ. 基本信息

创建日期：  2006-05-26 使用用户：  31 Github星：  5 插件作者：  Charles Campbell

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin '/vimball'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle '/vimball'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug '/vimball'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/vim-scripts/Vimball

Ⅳ. 文档说明

                                            [VIM VERSION 7.1 or 7.2 REQUIRED]

The vimball plugin facilitates creating, extracting , and listing the contents of "vimball" archives (*.vba).  Vimball also records the files extracted with it and can remove them.

CREATING A VIMBALL

Vimball can create a "vimball" archive (*.vba) with the following command:

   :[range]MkVimball[!] filename

As an example:

    plugin/something.vim
    doc/something.txt
    :%MkVimball something

will create a "vimball.vba" archive.  Each line in the range processed by the MkVimball command simply describes where in the usual vim directory tree various files are.  I am now also providing a C source program that creates vimballs; see http://www.drchip.org/astronaut/src/index.html#MKVIMBALL .

EXTRACTING FROM A VIMBALL

Users of a vimball archive simply need to

    $vim something.vba
    :so %

and the contents of the vimball will be extracted and placed into the proper directories, no matter where the user opened up the vimball.  Furthermore, the helptags command will be automatically and transparently used to make any doc/*.txt files' contents available by the Vim help system.

PREVIEWING A VIMBALL

Instead of immediately sourcing a vimball to extract its contents, one may use

    :VimballList

to preview the contents of the vimball archive.

(alpha/beta version available at http://www.drchip.org/astronaut/vim/index.html#VIMBALL)