VintageEx 技术文档

1. 安装指南

VintageEx 是一个为 Sublime Text 2 提供 Vim 命令行模式的插件。以下是安装步骤：

1. 下载最新版本：从提供的链接下载 VintageEx.sublime-package 文件。
2. 放置文件：将下载的文件放入 Sublime Text 的 Installed Packages 目录中。
3. 重启 Sublime Text：重启 Sublime Text 以完成安装。

注意：VintageEx 并不替代 Vintage 包。要使用 vi 键绑定，您需要启用 Sublime Text 自带的 Vintage 包（默认情况下被忽略）。

2. 项目的使用说明

VintageEx 扩展了 Vintage 提供的 vi 类似功能，添加了一个命令行模式，该模式尽量接近 Vim 的命令行模式。

打开命令行

按下 : 键即可打开命令行。

命令补全

VintageEx 提供了顶级命令的 Tab 补全功能。您可以输入一个字母并按 Tab 键来循环浏览可用的命令。

查看已实现的命令

您可以查看 ex_commands.py 文件来了解已实现的命令。

3. 项目 API 使用文档

VintageEx 的 API 主要围绕命令行模式的实现展开。以下是一些关键点：

• 命令行模式：通过 : 键触发，允许用户输入 Vim 风格的命令。
• 命令补全：支持 Tab 补全，方便用户快速输入命令。
• 命令执行：支持通过命令行执行各种操作，如文件保存、编辑等。

4. 项目安装方式

安装步骤

1. 下载包文件：从提供的链接下载 VintageEx.sublime-package 文件。
2. 放置文件：将下载的文件放入 Sublime Text 的 Installed Packages 目录中。
3. 重启 Sublime Text：重启 Sublime Text 以完成安装。

配置

以下配置应存储在您的个人偏好设置文件（Packages/User/Preferences.sublime-settings）中：

• vintageex_linux_shell：指定通过哪个 shell 执行命令（如 bash、ksh 等）。如果为空，则在需要时会读取 $SHELL 变量。
• vintageex_linux_terminal：指定首选的终端模拟器（如 gnome-terminal、xterm 等）。如果为空，则在需要时会依次读取 $COLORTERM 和 $TERM 变量。

总结

VintageEx 是一个强大的 Sublime Text 插件，为喜欢 Vim 风格编辑的用户提供了命令行模式。通过简单的安装和配置，您可以轻松地在 Sublime Text 中使用 Vim 的命令行功能。希望本文档能帮助您更好地理解和使用 VintageEx。