documentation/questions-and-answers.md

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