chromium-vim

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

喜欢 cVim 吗？考虑捐赠！https://www.paypal.me/1995eaton

cVim是什么？

Google Chrome 的 Vim。我讨厌用鼠标，尤其是在学会 Vim 之后。我的桌面（Linux）有很多按键绑定，让操作更简单：我用 Alt+w 打开 Chrome，用 Alt+Shift+d 关闭窗口，用 Alt+t 打开终端。Chrome 更难做到这一点，因为它没有自定义键盘快捷键的部分，而且点击链接等操作仍然需要用鼠标。cVim 旨在尽力消除这个问题，尽力通过 Chrome 扩展 API 实现。

我在哪里可以获得cVim？

• 有两种方式：
  • 你可以通过[Chrome网店]安装（https://chrome.google.com/webstore/detail/cvim/ihlenndgcmojhcghmfjfneahoeklbjjh ）
  • 你可以下载.zip文件[这里]（ https://github.com/1995eaton/chromium-vim/archive/master.zip）并启用cVim，方法是进入`chrome://extensions`网址，选择开发者模式，然后通过`Load unpacked extensions...`按钮将Chrome指向解压文件夹。

为什么这和Vimium、ViChrome或Vrome不同？

这些扩展在为 Google Chrome 添加类似 Vim 的快捷键方面做得非常出色，但它们缺少 Firefox 插件 Pentadactyl 所具备的许多功能。

• cVim 为 Chrome 添加了哪些功能？
  • Google/IMDB/维基百科/Amazon/Duckduckgo/Yahoo/Bing搜索完成
  • 支持自定义搜索引擎
  • 历史和书签搜索/完成，支持书签文件夹
  • Caret/可视化模式
  • 高效的链接提示（支持自定义映射）
  • 支持自定义键盘映射
  • 带高亮的正则表达式页面搜索
  • 带制表符补全的命令栏
  • 平滑滚动

cVim 帮助

cVimrc

• 布尔cVimrc设置在命令'set' + <SETTING_NAME>启用，命令'set' + no<SETTING_NAME>禁用（例如set regexp和set noregexp）
• 布尔cVimrc设置可以通过在末尾加上“！”来反转
• 其他设置则用=作为分隔符定义，并以let前缀（例如，let hintcharacters="abc"）

示例配置

" Settings
set nohud
set nosmoothscroll
set noautofocus " The opposite of autofocus; this setting stops
                " sites from focusing on an input box when they load
set typelinkhints
let searchlimit = 30
let scrollstep = 70
let barposition = "bottom"

let locale = "uk" " Current choices are 'jp' and 'uk'. This allows cVim to use sites like google.co.uk
                  " or google.co.jp to search rather than google.com. Support is currently limited.
                  " Let me know if you need a different locale for one of the completion/search engines
let hintcharacters = "abc123"

let searchengine dogpile = "http://www.dogpile.com/search/web?q=%s" " If you leave out the '%s' at the end of the URL,
                                                                    " your query will be appended to the link.
                                                                    " Otherwise, your query will replace the '%s'.

" This will do the same thing as above, except typing ':tabnew withbase' into to command bar
" without any search parameters will open 'http://www.dogpile.com'
let searchengine withbase = ["http://www.dogpile.com", "http://www.dogpile.com/search/web?q=%s"]

" alias ':g' to ':tabnew google'
command g tabnew google

let completionengines = ["google", "amazon", "imdb", "dogpile"]

let searchalias g = "google" " Create a shortcut for search engines.
                             " For example, typing ':tabnew g example'
                             " would act the same way as ':tabnew google example'

" Open all of these in a tab with `gna` or open one of these with <N>goa where <N>
let qmark a = ["http://www.reddit.com", "http://www.google.com", "http://twitter.com"]

let blacklists = ["https://mail.google.com/*", "*://mail.google.com/*", "@https://mail.google.com/mail/*"]
" blacklists prefixed by '@' act as a whitelist

let mapleader = ","

" Mappings

map <Leader>r reloadTabUncached
map <Leader>x :restore<Space>

" This remaps the default 'j' mapping
map j scrollUp

" You can use <Space>, which is interpreted as a
" literal " " character, to enter buffer completion mode
map gb :buffer<Space>

" This unmaps the default 'k' mapping
unmap k

" This unmaps the default 'h', 'j', 'k', and 'l' mappings
unmap h j k l

" This remaps the default 'f' mapping to the current 'F' mapping
map f F

" Toggle the current HUD display value
map <C-h> :set hud!<CR>

" Switch between alphabetical hint characters and numeric hints
map <C-i> :set numerichints!<CR>

map <C-u> rootFrame
map <M-h> previousTab
map <C-d> scrollPageDown
map <C-e> scrollPageUp
iunmap <C-y>
imap <C-m> deleteWord

" Create a variable that can be used/referenced in the command bar
let @@reddit_prog = 'http://www.reddit.com/r/programming'
let @@top_all = 'top?sort=top&t=all'
let @@top_day = 'top?sort=top&t=day'

" TA binding opens 'http://www.reddit.com/r/programming/top?sort=top&t=all' in a new tab
map TA :tabnew @@reddit_prog/@@top_all<CR>
map TD :tabnew @@reddit_prog/@@top_day<CR>

" Use paste buffer in mappings
map T :tabnew wikipedia @"<CR>

" Code blocks (see below for more info)
getIP() -> {{
httpRequest({url: 'http://api.ipify.org/?format=json', json: true},
            function(res) { Status.setMessage('IP: ' + res.ip); });
}}
" Displays your public IP address in the status bar
map ci :call getIP<CR>

" Script hints
echo(link) -> {{
  alert(link.href);
}}
map <C-f> createScriptHint(echo)

let configpath = '/path/to/your/.cvimrc'
set localconfig " Update settings via a local file (and the `:source` command) rather
                " than the default options page in chrome
" As long as localconfig is set in the .cvimrc file. cVim will continue to read
" settings from there

黑名单

• 黑名单设置使用了 Chrome @match 模式指南的自定义实现。有关语法描述，请参见 https://developer.chrome.com/extensions/match_patterns。

站点特定配置

• 您可以为使用上述描述的黑名单匹配模式的网站启用某些 rc 设置

  " this will enable the config block below on the domain 'reddit.com'
  site '*://*.reddit.com/*' {
    unmap j
    unmap k
    set numerichints
  }

页面加载时运行命令

• 与上面描述的特定网站配置类似，cVim 可以在页面加载时使用 call 关键字运行命令

  " In this case, when pages with a file ending in '.js' are loaded,
  " cVim will pin the tab and then scroll down
  site '*://*/*.js' {
    call :pintab
    call scrollDown
  }

映射

• 普通映射使用以下结构定义：map <KEY> <MAPPING_NAME>
• 插入映射使用相同的结构，但使用命令 "imap" 而不是 "map"
• Control、Meta 和 Alt 也可以使用：

  <C-u> " Ctrl + u
  <M-u> " Meta + u
  <A-u> " Alt  + u

• 也可以使用 unmap <KEY> 取消默认绑定，并使用 iunmap <KEY> 插入绑定
• 要取消映射所有默认键绑定，请使用 unmapAll。要取消映射所有默认插入绑定，请使用 iunmapAll

标签

• 打开链接的命令（:tabnew 和 :open）有三种不同的属性
  • ! => 在新标签页中打开
  • $ => 在新窗口中打开
  • | => 在隐身窗口中打开
  • & => 在新标签页中打开（未激活/未聚焦）
  • * => 固定标签
  • ? => 将查询视为搜索
  • = => 将查询视为 URL
• 这些属性的使用通过示例来解释最好：

:open! google<CR> " This is the same as :tabnew google<CR>

:open google!<CR> " This is another way of writing the above
                  " (these flags can can be added to either
                  " the base command or the end of the final command)

:open& google<CR> " This will open Google in a new inactive tab

:open$ google<CR> " This will open Google in a new window

:open&* google<CR> " The will open Google in a new inactive, pinned tab

:tabnew google&*<CR> " Once again, this will do the same thing as the above command

:open google&*<CR> " Again, same as above

:open google!& " Here, the & flag will cancel out the ! flag,
               " opening Google in a new inactive tab

" More examples
:bookmarks my_bookmark.com&  " inactive,new tab
:bookmarks&* my_bookmark.com " inactive,pinned,new tab
:bookmarks! my_bookmark.com  " new tab
:bookmarks$ my_bookmark.com  " new window
:bookmarks my_bookmark.com   " same tab

代码块

• 代码块允许你通过 cVimrc 与 cVim 的内容脚本进行交互。
• 由于代码块使用 eval(...)，你只有在清楚自己在做什么时才应该使用它们。

" To be used by the code block
set hintset_a

" Create a code block named switchHintCharacters
switchHintCharacters -> {{
  // We are now in JavaScript mode

  // Settings are contained in an object named settings
  settings.hintset_a = !settings.hintset_a;
  if (settings.hintset_a) {
    settings.hintcharacters = 'abc'; // equivalent to "let hintcharacters = 'abc'"
  } else {
    settings.hintcharacters = 'xyz';
  }

  // Propagate the current settings to all tabs for the
  // rest of the session
  PORT('syncSettings', { settings: settings });

  // Display cVim's status bar for 2 seconds.
  Status.setMessage('Hint Set: ' + (true ? 'a' : 'b'), 2);
}}

" Run the JavaScript block
map <Tab> :call switchHintCharacters<CR>

补全引擎

• 这些是可以在命令栏中使用的补全引擎列表。可以通过将它们的名称分配给 completionengines 变量的数组来设置它们。
  • 谷歌，维基百科，优酷，IMDb，亚马逊，谷歌地图，沃尔夫勒姆阿尔法，谷歌图片，易趣，韦氏词典，维基词典，城市词典，鸭鸭搜索，答案，谷歌趋势，谷歌财经，雅虎，必应，电影数据库
• 示例用法：

  let completionengines = ['google', 'google-image', 'youtube'] " Show only these engines in the command bar

按键绑定

命令模式

小贴士

• 你可以在“open”命令中使用 @% 来指定当前 URL。例如，:open @% 实际上会刷新当前页面。
• 在命令前加一个数字以将该命令重复 N 次
• 在命令/查找模式下使用上/下箭头浏览之前执行的命令/搜索 — 你也可以使用它来搜索以特定字母组合开头的先前执行的命令（例如，在命令栏中输入 ta 并按上箭头，将在命令历史中搜索所有以 ta 开头的匹配项）

贡献

很高兴你想花一些时间来改进这个扩展。解决问题总是受到欢迎的。如果你打算添加一个功能，最好提交一个问题。你会得到反馈，是否有可能被合并。

1. 在仓库的根文件夹中运行 npm install
2. 运行 make
3. 导航到 chrome://extensions
4. 切换到开发者模式
5. 点击“加载已解压的扩展程序...”
6. 选择 cVim 目录。