2 This is part of the VimFx documentation.
3 Copyright Simon Lydell 2015, 2016.
4 See the file README.md for copying conditions.
9 ## How do I disable VimFx?
11 If you press `i` you will enter Ignore mode. VimFx’s toolbar [button] turns red
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 key presses will be ignored by VimFx, and will be handled as if VimFx wasn’t
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._)
23 **The fastest way to edit the blacklist is to use the `gB` command.**
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
30 [blacklist]: options.md#blacklist
32 ## How do I get out of Ignore mode?
34 Either press `<s-escape>` or click VimFx’s toolbar [button].
38 ## What does `<s-escape>` mean?
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
44 (`<s-escape>` is the default shortcut to exit Ignore mode.)
46 [key notation]: shortcuts.md#key-notation
48 ## VimFx’s shortcuts work in my English layout but not in my other layout!
50 If you use more than one keyboard layout, such as Russian plus English, enable
51 the [Ignore keyboard layout] option.
53 [Ignore keyboard layout]: options.md#ignore-keyboard-layout
55 ## Can I make Hints mode work with element text?
57 … **like Vimium, Vimperator and Pentadactyl** can?
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.
62 [hint characters]: options.md#hint-characters
64 ## How do I change the font size of hint markers?
66 Head over to the [Styling] documentation to learn how to do that.
70 ## How do I re-map `<escape>` to blur text inputs?
72 The default shortcut is actually `<force><escape>`! Don’t forget [`<force>`] at
73 the beginning, and your new shortcut should work fine.
75 [`<force>`]: shortcuts.md#force
77 ## Going back/forward doesn’t work!
79 Pressing `H` is like hitting the back button. Use `L` for the forward button.
81 `[` clicks the link labeled “Previous” on the page, and `]` the link labeled
82 “Next.” (See also [“Previous”/“Next” link patterns].)
84 [“Previous”/“Next” link patterns]: options.md#previousnext-link-patterns
86 ## Can I search in the Keyboard Shortcuts help dialog?
88 Yes! Pressing `/` while the help dialog is open makes a little search box appear
89 in the bottom-right corner of the window (instead of opening the find bar),
90 which is specialized at searching your keyboard shortcuts.
92 ## Can I edit shortcuts in the Keyboard Shortcuts help dialog?
94 Clicking on any command in it opens VimFx’s options page in the Add-ons Manager
95 and automatically selects the text input for that command. Tip: Use the `eb`
96 command to click without using the mouse.
98 ## Will VimFx provide advanced Find features?
100 One of VimFx’s key features is to embrace standard Firefox features. As long as
101 Firefox’s Find Bar doesn’t support for example reverse search (Vim’s `?`
102 command) or regex search, VimFx won’t either.
104 ## Switching between tabs works oddly when [NoScript] is installed!
106 This is a [known bug][noscript-bug] in NoScript. To work around it, either
107 switch to multi-process Firefox or set `noscript.clearClick.rapidFireCheck` to
108 `false` in [about:config].
110 You’re not really missing out security-wise by disabling
111 `noscript.clearClick.rapidFireCheck`. All it does is preventing one specific,
112 less common type of “clickjacking” attack, that isn’t even mentioned in
113 NoScript’s [ClearClick] documentation. It is, however, quickly mentionend in a
114 [blog post][hackademix-clickjacking] by NoScript’s author (which links to
115 another site explaining the attack in more detail).
117 See also [issue 588].
119 [NoScript]: https://noscript.net/
120 [noscript-bug]: https://forums.informaction.com/viewtopic.php?f=10&t=21597
121 [about:config]: http://kb.mozillazine.org/About:config
122 [ClearClick]: https://noscript.net/faq/#clearclick
123 [hackademix-clickjacking]: https://hackademix.net/2011/07/11/fancy-clickjacking-tougher-noscript/
124 [issue 588]: https://github.com/akhodakivskiy/VimFx/issues/588
126 ## My question isn’t listed here!
128 Tell us, and we’ll add it. Let’s make this a great resource for new users.