diff --git a/docs/index.md b/docs/index.md index ad7c911..7917645 100644 --- a/docs/index.md +++ b/docs/index.md @@ -9,7 +9,52 @@ keyboard. Since version 57, Firefox has migrated to the WebExtensions API and has dropped support for legacy add-ons. Vim Vixen is a new choice for Vim users since it uses the WebExtensions API. -## Related links +## Getting started -- [Vim Vixen - GitHub](https://github.com/ueokande/vim-vixen) -- [Vim Vixen - Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/vim-vixen/) +### Install Vim Vixen + +Vim Vixen is supported on Firefox 60 ESR. Please latest version of stable ESR +from the [download page](https://www.mozilla.org/en-US/firefox/). +You can install Vim Vixen from [Firefox add-ons (addons.mozilla.org)][AMO], and +manage installed addon-ons on Firefox preferences `about:preferences`. + +### Quick start + +After installation, you can control Firefox with vim-like keymaps. To scroll a +page in the browser, press k, j, h and +l keys. You can scroll to the top or the bottom of a page by +gg and G. + +To select a left and right of current tab, use K and J +respectively. To close current tab, use d and to restore closed +tabs, use u. + +To open a link, press f to enter the **follow mode** to select a +link. Then you can select links by alphabetic keys. + +See also [Keymaps](./keymaps.html) for more detailed of keymaps. + +### Using commands + +Vim Vixen supports command line to run commands that control tabs and opens a +tab. To open command line, press :. + +To open a tab with URL, use `open` command as the following: + +``` +:open https://github.com/ueokande/vimvixen +``` + +or search keywords with search engine (such as Google) like: + +``` +:open How to use Vim +``` + +You can see completed commands on [Console commands](./console_commands.html). + +## Copyright + +Copyright © 2017-2019 by Shin'ya Ueoka + +[AMO]: https://addons.mozilla.org/en-US/firefox/addon/vim-vixen/ diff --git a/docs/keymaps.md b/docs/keymaps.md index 8952392..9ae0c98 100644 --- a/docs/keymaps.md +++ b/docs/keymaps.md @@ -7,32 +7,6 @@ title: Keymaps Keymaps are configurable in the add-on's preferences by navigating to `about:addons` and selecting "Extensions". The default mappings are as follows: -## Console - -- :: open the console -- o, t, w: open a page in the current tab, a new tab, or new window -- O, T, W: similar to o, t, w, but using the current URL -- b: select tabs by URL or title -- a: add the current page to your bookmarks - -See the [console commands](./console_commands.html) section for a more detailed description. - -## Tabs - -- d: delete the current tab and select the tab to its right -- D: delete the current tab and select the tab to its left -- !d: delete a pinned tab -- u: reopen a close tab -- r: reload the current tab -- R: reload the current tab, bypassing the cache -- K or gT: select the previous tab -- J or gt: select the next tab -- g0: select the first tab -- g$: select the last tab -- Ctrl+6: open the previously-selected tab -- zp: pin the curent tab tab -- zd: duplicate the current tab - ## Scrolling - k: scroll up @@ -53,6 +27,32 @@ See the [console commands](./console_commands.html) section for a more detailed Lowercase marks (`[a-z]`) store the position of the current tab. Uppercase and numeric marks (`[A-Z0-9]`) store the position and the tab. +## Select and manage tabs + +- d: delete the current tab and select the tab to its right +- D: delete the current tab and select the tab to its left +- !d: delete a pinned tab +- u: reopen a close tab +- r: reload the current tab +- R: reload the current tab, bypassing the cache +- K or gT: select the previous tab +- J or gt: select the next tab +- g0: select the first tab +- g$: select the last tab +- Ctrl+6: open the previously-selected tab +- zp: pin the curent tab tab +- zd: duplicate the current tab + +## Console + +- :: open the console +- o, t, w: open a page in the current tab, a new tab, or new window +- O, T, W: similar to o, t, w, but using the current URL +- b: select tabs by URL or title +- a: add the current page to your bookmarks + +See the [console commands](./console_commands.html) section for a more detailed description. + ## Zoom - zi: zoom in