Vim Keybindings for Safari 技术文档

1. 安装指南

安装步骤

1. 打开Safari浏览器。
2. 进入Safari扩展商店。
3. 搜索“Vim Keybindings for Safari”扩展。
4. 点击“安装”按钮进行安装。
5. 安装完成后，重启Safari浏览器。

配置

1. 安装完成后，点击Safari菜单栏中的“偏好设置”。
2. 在“扩展”选项卡中，找到并启用“Vim Keybindings for Safari”扩展。
3. 在扩展的偏好设置中，可以配置不需要加载扩展的网站列表，多个网站之间用逗号分隔。

2. 项目的使用说明

基本功能

• 导航键：gg（跳到页面顶部）、G（跳到页面底部）、h（左移）、j（下移）、k（上移）、l（右移）。
• 页面滚动：^D（向下滚动半页）、^U（向上滚动半页）、^F（向下滚动一页）、^B（向上滚动一页）。
• 编辑模式：esc（退出编辑模式）、i（进入编辑模式）、dd（删除当前行）。
• 标签页操作：gt（下一个标签页）、gT（上一个标签页）、<number>gt（跳转到指定编号的标签页）。

命令模式

• 退出：:q（退出当前标签页）、:q!（强制退出当前标签页）。
• 新建标签页：:tabnew。
• 标签页导航：:tabn（下一个标签页）、:tabp（上一个标签页）、:tabfir 或 :tabfirst（第一个标签页）、:tablast（最后一个标签页）。
• 编辑URL：:e @url、:edit @url、:tabe @url、:tabedit @url。
• 查找替换：:%s/@search/@replace。

注意事项

• @url 需要是一个有效的URL，如果未提供http://，扩展会自动添加。
• @search 和 @replace 需要是正则表达式，支持修饰符，但使用的是JavaScript引擎，而非Vim引擎。

3. 项目API使用文档

命令模式API

• :q：退出当前标签页。
• :q!：强制退出当前标签页。
• :tabnew：新建一个标签页。
• :tabn：切换到下一个标签页。
• :tabp：切换到上一个标签页。
• :tabfir 或 :tabfirst：切换到第一个标签页。
• :tablast：切换到最后一个标签页。
• :e @url、:edit @url、:tabe @url、:tabedit @url：在当前或新标签页中打开指定URL。
• :%s/@search/@replace：在当前页面中查找并替换内容。

快捷键API

• gg：跳到页面顶部。
• G：跳到页面底部。
• h、j、k、l：页面导航。
• ^D、^U、^F、^B：页面滚动。
• esc：退出编辑模式。
• i：进入编辑模式。
• dd：删除当前行。
• gt、gT、<number>gt：标签页导航。

4. 项目安装方式

通过Safari扩展商店安装

1. 打开Safari浏览器。
2. 进入Safari扩展商店。
3. 搜索“Vim Keybindings for Safari”扩展。
4. 点击“安装”按钮进行安装。
5. 安装完成后，重启Safari浏览器。

手动安装（适用于开发者）

1. 克隆项目仓库到本地。
2. 打开Safari的“开发”菜单，选择“显示扩展构建器”。
3. 点击“+”按钮，选择“添加扩展”。
4. 选择克隆的项目文件夹。
5. 点击“安装”按钮进行安装。
6. 安装完成后，重启Safari浏览器。

已知问题

• 某些页面会接管键盘输入，导致扩展的覆盖层无法显示或接收键盘输入。
• 某些页面会导致gt和gT组合键跳过页面内容。

贡献者

• Mutwin Kraus
• Jason Green
• Jannik Nielsen