From cacdce73987cc985d262c4d9b17da0e5044c2297 Mon Sep 17 00:00:00 2001 From: Grant Surratt Date: Mon, 30 Oct 2017 09:24:08 -0700 Subject: [PATCH] Minor adjustments in readme for clarification --- README.md | 33 ++++++++++++++++----------------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 7f6a44e..8540d47 100644 --- a/README.md +++ b/README.md @@ -3,14 +3,14 @@ Vim Vixen is a Firefox add-on which allows you to navigate with keyboard on the browser. Firefox started to support WebExtensions API and will stop supporting add-ons using legacy APIs from version 57. For this reason, many legacy add-ons do not work on Firefox 57. -and Vim Vixen is a new choise for Vim users since Vim Vixen uses WebExtensions API +Vim Vixen is a new choice for Vim users since Vim Vixen uses the WebExtensions API. ## Basic usage ### Key-maps -The key-maps are configurable in preferences of the add-ons. -The default mapping are shown in the following. +The key-maps are configurable in the add-ons preferences by navigating to `about:addons` and selecting "Extensions". +The default mappings are as follows: #### Console @@ -51,34 +51,33 @@ The default mapping are shown in the following. ### Console commands -Vim-Vixen provides a console like the Vimperator's one. +Vim Vixen provides a console for `ex`-style commands similar to Vimperator. Open the console with :. Or start it with initial values using o, t, or w. #### `:open` command -Open a URL or search keywords by search engine in current tab, -When specified parameter is formatted in URL as following, URL is opened to current tab. +The `:open` command operates two different ways, depending on the parameter. +When the parameter is a URL, that URL is opened in the current tab. ``` :open http://github.com/ueokande ``` -If specified parameters are keywords as following, open new tab searched by the -keywords with search engines (default to Google). +Otherwise, the current tab will open a search page with the supplied string (defaults to Google). ``` :open How to contribute to Vim-Vixen ``` -You can specify search engines in first parameter. -For the default of search engines, see [search engines](#search-engines) section. +To use a search engine other than the default, specify which search engine to use as the first parameter. ``` :open yahoo How to contribute to Vim-Vixen ``` +To adjust the search engine default and add/remove search engines, see the [search engines](#search-engines) section. #### `:tabopen` command @@ -94,12 +93,11 @@ Select tabs by URL or title matched by keywords. ### Search engines -Vim-Vixen support to search by search engines such as google or yahoo. -But the engines are independent on browsers' because of there is a limitation of WebExtensions. +Vim Vixen supports search by search engines like Google and Yahoo. -You can configure search engines and default search engine in preferences of the add-ons. -The URLs specified in `"engines"` must contain a {}-placeholder, which will -replaced with keywords in parameters of the command. +You can configure search engines, including the default search engine, in the add-ons preferences. +The URLs specified in `"engines"` must contain a {}-placeholder, which will be +replaced with the search keyword parameters of the command. ```json { @@ -119,10 +117,9 @@ replaced with keywords in parameters of the command. ### Blacklist -Blacklist allows to disable the plugin for certain pages by URL patterns. +The blacklist allows you to disable the plugin for certain pages by URL patterns. For instance, when you describe `"*.slack.com"`, the plugin is disabled on any Slack rooms. In addition, you can also specify path patterns, such as `"example.com/mail/*"`. -Disabled plugin can be made re-enabled by Shift+Esc (in default). ```json { @@ -133,6 +130,8 @@ Disabled plugin can be made re-enabled by Shift+Esc (in default). } ``` +You can toggle Vim Vixen between disabled and enabled with `shift + Esc`. + ## Licence MIT