*pi_vimball.txt* For Vim version 8.0. 最近更新: 2017年8月
--------------------
Vimball 归档处理程序
--------------------
译者: Willis
http://vimcdoc.sf.net
Author: Charles E. Campbell <NdrOchip@ScampbellPfamily.AbizM>
(remove NOSPAM from Campbell's email first)
Copyright: (c) 2004-2015 by Charles E. Campbell *Vimball-copyright*
The VIM LICENSE (see |copyright|) applies to the files in this
package, including vimballPlugin.vim, vimball.vim, and pi_vimball.txt.
except use "vimball" instead of "VIM". Like anything else that's free,
vimball.vim and its associated files are provided *as is* and comes with
no warranty of any kind, either expressed or implied. No guarantees
of merchantability. No guarantees of suitability for any purpose. By
using this plugin, you agree that in no event will the copyright
holder be liable for any damages resulting from the use of this
software. Use at your own risk!
==============================================================================
1. 内容 *vba* *vimball* *vimball-contents*
1. 内容..........................................: |vimball-contents|
2. Vimball 简介..................................: |vimball-intro|
3. Vimball 手册..................................: |vimball-manual|
MkVimball.....................................: |:MkVimball|
UseVimball....................................: |:UseVimball|
RmVimball.....................................: |:RmVimball|
4. Vimball 历史..................................: |vimball-history|
==============================================================================
2. Vimball 简介 *vimball-intro*
Vimball 的目标就是使插件用户的使用更方便。有了 vimball 以后，用户只需
要: >
< 然后插件和它的所有部件都会被安装在合适的目录里。注意 用户无须刻意进到
某个特定的目录来执行此命令。另外，插件的帮助也会被自动安装。
如果用户决定使用 AsNeeded 插件，vimball 会聪明地把本来要放到
.vim/plugin/ 中的脚本放到 .vim/AsNeeded/ 里去。
删除 vimball 安装的插件很容易: >
< 举例说吧，zip 和 tarball 对应的操作就不是那么简单了。
Vimball 检视用户的 |'runtimepath'| 来确定把脚本放在哪里。如果可能，通
常使用 runtimepath 提到的第一个目录。用 >
< 来查看该目录。
==============================================================================
3. Vimball 手册 *vimball-manual*
创 建 VIMBALL *:MkVimball*
:[range]MkVimball[!] filename [path]
行范围内指定要保存在 vimball 里的文件的路径，但不包含通常在
runtimepath (|'rtp'|) 指定的那部分。例如: >
< 在此范围的行上使用 >
<
建立文件 "filename.vba"，Vimball.vim 随后可以用它来还原那些文件。如果
文件 "filename.vba" 已经存在，MKVimball 会给出警告而不建立文件。注意
这些路径都相对于你的 .vim (vimfiles) 目录，而所有文件都应该在该目录
下。更准确地说，vimball 插件通常使用 'runtimepath' 里第一个存在的目录
作为前缀；它不使用绝对路径，除非用户指定的就是如此。
如果使用感叹号 (!)，MkVimball 总是建立 "filename.vba" 文件。如果已经存
在则覆盖之。此行为和 |:w| 类似。
如要强制允许文件名中包含斜杠，也可用感叹号版本实现 (即 :MkVimball!
path/filename)。
http://vim.wikia.com/wiki/Using_VimBall_with_%27Make%27 给出的技巧提供
了用 make 自动生成 vimball 的好方法。
通 过 VIMBALL 建 立 目 录 *g:vimball_mkdir*
首先尝试 |mkdir()| 命令 (并非所有系统都支持)。
如果该命令不存在，而且 g:vimball_mkdir 也不存在，它被设为: >
< 用户可以自定义 g:vimball_mkdir 来直接指定建立目录的命令。vimball 如有
需要，会通过该命令来建立目录。
控 制 VIMBALL 提 取 目 录 *g:vimball_home*
通过指定变量 g:vimball_home，你可以覆盖 |'runtimepath'| 的使用。
**
vim filename.vba
简单编辑一个 vimball 文件，Vimball.vim 会告诉用户必须执行 (source) 该
归档的内容才能提取其中的文件。
只有首行是 "Vimball Archiver by Charles E. Campbell" 的文件才会被认为
是 vimball 文件，从而才会继续提取操作。
列 出 VIMBALL 中 的 文 件 *:VimballList*
:VimballList
本命令告诉 Vim 列出归档里的所有文件，包括每个文件的行数。
手 动 执 行 VIMABALL 提 取 *:UseVimball*
:UseVimball [path]
vimball 文件本身包含了该命令；它调用 vimball#Vimball() 例程，后者负责
对 vimball 解包。用户可以手动执行该命令，而无须执行 vimball；用户还可
以指定安装的路径来覆盖自动的选择，即 |'runtimepath'| 里的第一个存在的
目录。
删 除 VIMBALL *:RmVimball*
:RmVimball vimballfile [path]
本命令删除制定 vimball 产生的所有文件 (但不包括它可能建立的任何目录)。
用户也选择卸载文件的路径 (见 |'runtimepath'|)；否则，缺省是
'runtimepath' 里的第一个存在的目录。
为了实现这一点，该目录下包含一个文件 (.VimballRecord)，它包含了目前为
止所有使用过的 vimball 中要删除的文件的记录。
禁 止 载 入
如果由于某种原因你不想使用 vimball 提取插件，在 <.vimrc> 中加入以下两
个变量就可以不载入 vimball.vim: >
<
WINDDOWS *vimball-windows*
许多 vimball 文件使用 gzip 压缩。Windows 不幸地没有自带解压 gzip 文件
的工具。幸运的是，Windows 用户可以找到不少解压 gzip 的工具:
>
<
==============================================================================
+-- 95 lines: 4. Vimball 历史 (英文) *vimball-history* ---------------------------------------------------------------------------------------