]> git.gir.st - VimFx.git/blob - documentation/questions-and-answers.md
Consistently name the help dialog is user-facing code
[VimFx.git] / 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 key presses 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 Finally, there’s nothing stopping you from hitting the “Disable” button in the
24 Add-ons Manager if you want to disable VimFx completely (just like you can with
25 any add-on).
26
27 [button]: button.md
28 [blacklist]: options.md#blacklist
29
30 ## How do I get out of Ignore mode?
31
32 Either press `<s-escape>` or click VimFx’s toolbar [button].
33
34 [button]: button.md
35
36 ## What does `<s-escape>` mean?
37
38 It means that you should press Escape while holding shift. In some other
39 programs it might be written as `Shift+Escape`, but not in VimFx’s [key
40 notation].
41
42 (`<s-escape>` is the default shortcut to exit Ignore mode.)
43
44 [key notation]: shortcuts.md#key-notation
45
46 ## VimFx’s shortcuts work in my English layout but not in my other layout!
47
48 If you use more than one keyboard layout, such as Russian plus English, enable
49 the [Ignore keyboard layout] option.
50
51 [Ignore keyboard layout]: options.md#ignore-keyboard-layout
52
53 ## Going back/forward doesn’t work!
54
55 Pressing `H` is like hitting the back button. Use `L` for the forward button.
56
57 `[` clicks the link labeled “Previous” on the page, and `]` the link labeled
58 “Next.” (See also the [“Previous”/“Next” link patterns] option.)
59
60 [“Previous”/“Next” link patterns]: options.md#previousnext-link-patterns
61
62 ## How do I re-map `<escape>` to blur text inputs?
63
64 The default shortcut is actually `<force><escape>`! Don’t forget [`<force>`] at
65 the beginning, and your new shortcut should work fine.
66
67 [`<force>`]: shortcuts.md#force
68
69 ## Can I search in the Keyboard Shortcuts help dialog?
70
71 Yes! Pressing `/` while the help dialog is open makes a little search box appear
72 in the bottom-right corner of the window (instead of opening the find bar),
73 which is specialized at searching your keyboard shortcuts.
74
75 ## Can I edit shortcuts in the Keyboard Shortcuts help dialog?
76
77 No, but clicking on any command in it opens VimFx’s settings page in the Add-ons
78 Manager and automatically selects the text input for that command. Tip: Use the
79 `zF` command to click without using the mouse.
80
81 ## Will VimFx provide advanced Find features?
82
83 One of VimFx’s key features is to embrace standard Firefox features. As long as
84 Firefox’s Find Bar doesn’t support for example reverse search (vim’s `?`
85 command) or regex search, VimFx won’t either.
86
87 (The [public API] could be used, though, to integrate with another Add-on that
88 provides advanced Find features.)
89
90 [public API]: api.md
91
92 ## My question isn’t listed here!
93
94 Tell us, and we’ll add it. Let’s make this a great resource for new users.
Imprint / Impressum