Vim_AHK 项目技术文档

Vim_AHK 项目技术文档

vim_ahk Setting file to emulate vim with AutoHotkey 项目地址: https://gitcode.com/gh_mirrors/vi/vim_ahk

安装指南

脚本安装

1. 前提条件：确保已安装 AutoHotKey。
2. 安装步骤：
   • 打开 vim.ahk 文件，AutoHotKey 会自动加载该脚本。
   • 如果已经在运行其他 AutoHotKey 脚本，可以将 vim.ahk 和 lib 目录复制到 \Users\%username%\Documents 或脚本所在目录。
   • 在 AutoHotkey.ahk 或你的脚本末尾添加以下行：

     #Include %A_LineFile%\..\vim.ahk
     

可执行文件安装

1. 下载：访问 发布页面 下载最新版本的 zip 文件。
2. 解压：将 zip 文件解压到你喜欢的目录。
3. 运行：启动 vim_ahk.exe。
   • 注意：确保 vim_ahk_icons 文件夹与 vim_ahk.exe 在同一目录，否则托盘菜单图标功能将无法工作。

从源码构建可执行文件

1. 克隆项目：克隆 vim_ahk 项目并进入项目目录。
2. 构建：运行 build.bat。
   • 双击文件或通过 PowerShell 或命令提示符运行 .\build.bat。
3. 结果：你将找到包含 vim_ahk.exe 和 vim_ahk_icons 的 vim_ahk 文件夹。

项目使用说明

应用程序支持

默认设置启用了以下应用程序的 Vim 模式：

• 记事本 (メモ帳)
• 写字板
• TeraPad
• Windows 资源管理器
• Thunderbird (仅发送窗口)
• Microsoft PowerPoint
• Microsoft Word
• Evernote
• Visual Studio Code
• TexWork
• TexStudio
• Q-dir
• OneNote
• 使用 ahk_exe ApplicationFrameHost.exe 的应用程序

你可以通过任务栏图标的右键菜单（找到 VimMenu-Settings）或按 Ctrl-Alt-Shift-v 启动设置窗口来更改这些设置。

自定义应用程序

如果你想直接在脚本中更改应用程序，可以在 vim.ahk 中添加 VimGroup 变量，例如：

VimGroup := "ahk_exe chrome.exe,ahk_exe firefox.exe"

选项设置

你可以在脚本中添加选项，例如：

VimVerbose := 2
#Include \path\to\vim.ahk

GUI 选项设置窗口

你可以通过任务栏图标的右键菜单或按 Ctrl-Alt-Shift-v 启动设置窗口来更改选项。

项目API使用文档

全局快捷键

| 快捷键 | 功能 | |:--------------------:|:-------------------------| | Ctrl-Alt-Shift-v | 启动 GUI 选项设置窗口 | | Ctrl-Alt-Shift-s | 挂起/重启 vim_ahk | | Ctrl-Alt-Shift-c | 显示状态检查窗口 |

主要模式

| 模式 | 描述 | |:----------:|:-------------------------| | 插入模式 | 原始 Windows 状态 | | 普通模式 | 类似 Vim，光标通过 hjkl、w 等移动，支持一些 Vim 命令 | | 可视模式 | 有三种可视模式：字符、行和块。块可视模式仅在支持块选择的应用程序中有效 | | 命令模式 | 用于保存文件/退出 |

项目安装方式

脚本安装

1. 复制 vim.ahk 和 lib 目录到指定目录。
2. 在脚本中添加 #Include %A_LineFile%\..\vim.ahk。

可执行文件安装

1. 下载并解压 zip 文件。
2. 运行 vim_ahk.exe。

从源码构建

1. 克隆项目并运行 build.bat。

vim_ahk Setting file to emulate vim with AutoHotkey 项目地址: https://gitcode.com/gh_mirrors/vi/vim_ahk