documentation/questions-and-answers.md

   1 # Questions & Answers
   2
   3 ## I can’t install VimFx!
   4
   5 That’s probably because VimFx is a _legacy_ Firefox extension, which requires
   6 [LegacyFox] for installation.
   7
   8 [LegacyFox]: https://git.gir.st/LegacyFox.git
   9
  10 ## How do I disable VimFx?
  11
  12 If you press `i` you will enter Ignore mode. VimFx’s toolbar [button] turns red
  13 to reflect this.
  14
  15 As you can see in VimFx’s Keyboard Shortcuts help dialog (which you can open by
  16 pressing `?`), Ignore mode only has two shortcuts. That means that almost all
  17 keypresses will be ignored by VimFx, and will be handled as if VimFx wasn’t
  18 installed.
  19
  20 By adding `*currentdomain.com*` to the [blacklist] option you can make VimFx
  21 start out in Ignore mode on currentdomain.com. (Set the option to `*` to make
  22 VimFx start out in Ignore mode _everywhere._)
  23
  24 **The fastest way to edit the blacklist is to use the `gB` command.**
  25
  26 Finally, there’s nothing stopping you from hitting the “Disable” button in the
  27 Add-ons Manager if you want to disable VimFx completely (just like you can with
  28 any add-on).
  29
  30 [button]: button.md
  31 [blacklist]: options.md#blacklist
  32
  33 ## How do I get out of Ignore mode?
  34
  35 Either press `<s-escape>` or click VimFx’s toolbar [button].
  36
  37 [button]: button.md
  38
  39 ## What does `<s-escape>` mean?
  40
  41 It means that you should press Escape while holding shift. In some other
  42 programs it might be written as `Shift+Escape`, but not in VimFx’s [key
  43 notation].
  44
  45 (`<s-escape>` is the default shortcut to exit Ignore mode.)
  46
  47 [key notation]: shortcuts.md#key-notation
  48
  49 ## VimFx’s shortcuts work in my English layout but not in my other layout!
  50
  51 If you use more than one keyboard layout, such as Russian plus English, enable
  52 the [Ignore keyboard layout] option.
  53
  54 [Ignore keyboard layout]: options.md#ignore-keyboard-layout
  55
  56 ## Can I make Hints mode work with element text?
  57
  58 … **like Vimium, Vimperator and Pentadactyl** can?
  59
  60 Yes! By default, that is done by typing _uppercase_ characters (hold down
  61 shift!). Have a look at how [hint characters] work for more information.
  62
  63 [hint characters]: options.md#hint-characters
  64
  65 ## How do I change the font size of hint markers?
  66
  67 Head over to the [Styling] documentation to learn how to do that.
  68
  69 [Styling]: styling.md
  70
  71 ## How do I re-map Escape (which blurs text inputs)?
  72
  73 … for example, **to ctrl+[ ?**
  74
  75 First off, ctrl+[ is spelled `<c-[>` in VimFx. (Tip: [`<c-q>` helps you get the
  76 “spelling” correct automatically][helper-shortcuts].)
  77
  78 Secondly, the default shortcut is not just `<escape>`, but actually
  79 `<force><escape>`! Don’t forget [`<force>`] at the beginning, and your new
  80 shortcut should work fine. For example:
  81
  82     <force><c-[>
  83
  84 Or, if you’d like to you both `<escape>` _and_ something else:
  85
  86     <force><escape>    <force><c-[>
  87
  88 [`<force>`]: shortcuts.md#force
  89
  90 ## Re-mapping Escape doesn’t always work!
  91
  92 There are several default shortcuts which use `<escape>`. Apart from the Normal
  93 mode command for blurring text inputs, the Caret, Hints, Find and Marks modes
  94 have one command each for returning to Normal mode. All of these use `<escape>`.
  95
  96 Perhaps you forgot to re-map some of them?
  97
  98 ## Going back/forward doesn’t work!
  99
 100 Pressing `H` is like hitting the back button. Use `L` for the forward button.
 101
 102 `[` clicks the link labeled “Previous” on the page, and `]` the link labeled
 103 “Next.” (See also [“Previous”/“Next” link patterns].)
 104
 105 [helper-shortcuts]: shortcuts.md#helper-keyboard-shortcuts
 106 [“Previous”/“Next” link patterns]: options.md#previousnext-link-patterns
 107
 108 ## How do I switch tabs?
 109
 110 There are a bunch of VimFx commands for switching tabs, such as [`J` and `K`],
 111 [`gl`], [`gL`][gl-1] as well as [`g0`, `g^` and `g$`].
 112
 113 Other than that, you can use the `eb` command to click tabs using hint markers.
 114
 115 Firefox’s location bar also searches among your open tabs, and lets you switch
 116 to them. By typing a lone `%` in the location bar, _only_ open tabs are searched
 117 for. See [Handy standard Firefox features][location-bar] for more information.
 118
 119 Finally, there’s nothing stopping you from also using [standard Firefox tab
 120 shortcuts]!
 121
 122 [`J` and `K`]: commands.md#j-k
 123 [`gl`]: commands.md#gl
 124 [gl-1]: commands.md#gl-1
 125 [`g0`, `g^` and `g$`]: commands.md#g0-g-g
 126 [location-bar]: handy-standard-firefox-features.md#the-location-bar
 127 [standard Firefox tab shortcuts]: https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly#w_windows-tabs
 128
 129 ## Can I search in the Keyboard Shortcuts help dialog?
 130
 131 Yes! Pressing `/` while the help dialog is open makes a little search box appear
 132 in the bottom-right corner of the window (instead of opening the find bar),
 133 which is specialized at searching your keyboard shortcuts.
 134
 135 ## Can I edit shortcuts in the Keyboard Shortcuts help dialog?
 136
 137 Clicking on any command in it opens VimFx’s options page in the Add-ons Manager
 138 and automatically selects the text input for that command. Tip: Use the `eb`
 139 command to click without using the mouse.
 140
 141 ## Will VimFx provide advanced Find features?
 142
 143 One of VimFx’s key features is to embrace standard Firefox features. As long as
 144 Firefox’s Find Bar doesn’t support for example reverse search (Vim’s `?`
 145 command) or regex search, VimFx won’t either.