documentation/questions-and-answers.md

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