1 <?xml version="1.0" encoding="UTF-8"?>
2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
4 <!DOCTYPE document SYSTEM "dactyl://content/dtd">
8 title="&dactyl.appName; Browsing"
10 xmlns:html="&xmlns.html;">
12 <h1 tag="surfing browsing">Browsing</h1>
15 <h2 tag="bypassing-&dactyl.name;">Bypassing &dactyl.appName;</h2>
17 &dactyl.appName; overrides nearly all &dactyl.host; keys in order to
18 make browsing more pleasant for Vim users. On the occasions when you
19 want to bypass &dactyl.appName;'s key handling and pass keys directly to
20 &dactyl.host; or to a web page, you have two options:
23 <tags><![CDATA[<A-b>]]></tags>
24 <spec><![CDATA[<A-b>]]></spec>
27 Process the next key as a builtin mapping, ignoring any user defined
28 mappings and <o>passkeys</o> settings.
34 <tags><![CDATA[send-key <pass-next-key> <C-v> CTRL-V]]></tags>
35 <spec><![CDATA[<C-v>]]></spec>
38 Pass the next key press directly to &dactyl.host;.
44 <tags><![CDATA[pass-through <pass-all-keys> <C-z> CTRL-Z]]></tags>
45 <spec><![CDATA[<C-z>]]></spec>
48 Pass all keys except for <k name="Esc"/> directly to
49 &dactyl.host;. When <k name="Esc"/> is pressed,
50 resume normal key handling. This is especially useful
51 for web sites which make heavy use of key bindings.
56 <h2 tag="opening">Opening web pages</h2>
59 <tags>o :o :open</tags>
60 <spec>:o<oa>pen</oa> <oa>args</oa></spec>
64 Open a single URL in the current tab, or multiple URLs
65 in the current tab and background tabs. URLs may be
66 separated with <o>urlseparator</o>, in which case the
67 first URL is opened in the current tab and the rest are
68 opened in new background tabs.
72 Each URL may be one of the following:
77 A local filename, if it begins with <em>/</em>,
78 <em>./</em>, or <em>~/</em> and the specified file
83 A search or bookmark keyword, or a search engine
84 name, followed by search arguments.
86 <example><ex>:open wikipedia Linus Torvalds</ex></example>
88 Search engines can be edited via
89 <ex>:dialog searchengines</ex> and search
90 keywords may be added by right clicking any
91 search box and selecting <str>Add a Keyword for
97 Any search string which does not look like a URL or
98 hostname, which will be passed to the default
99 search engine (see <o>defsearch</o>).
101 <example><ex>:open Linus Torvalds</ex></example>
104 Any other value is passed directly &dactyl.host; and
105 must be a valid URL or hostname.
110 <ex>:open</ex> provides powerful URL completion from
111 several possible sources, which can be adjusted via the
112 <o>complete</o> option.
118 <tags>t :t :tabopen :tabnew</tags>
119 <spec>:tabopen<oa>!</oa> <oa>args</oa></spec>
123 Like <ex>:open</ex>, but all arguments are opened in new
124 tabs. The first new tab is activated if <o>activate</o>
125 contains <str>tabopen</str> or <oa>!</oa> is provided.
133 <description short="true">
135 Open a <ex>:tabopen</ex> prompt followed by the current URL.
141 <tags>:tabdu :tabduplicate</tags>
142 <spec>:<oa>count</oa>tabdu<oa>plicate</oa><oa>!</oa></spec>
145 Duplicates current tab <oa>count</oa> times. The first
146 new tab is activated if <o>activate</o> contains
147 <str>tabopen</str> or <oa>!</oa> is provided.
155 <description short="true">
157 Open an <ex>:open</ex> prompt followed by the current URL.
163 <tags>w :winopen :wopen</tags>
164 <spec>:wino<oa>pen</oa><oa>!</oa> <oa>args</oa></spec>
168 Like <ex>:tabopen</ex>, but all arguments are opened in
177 <description short="true">
179 Open a <ex>:winopen</ex> prompt followed by the current URL.
185 <tags><![CDATA[<open-clipboard-url> <MiddleMouse> p]]></tags>
190 Open (put) a URL based on the current clipboard
191 contents, or, on X11 systems, the currently selected
192 text. All white space is stripped from the selection and
193 it is opened in the same manner as <ex>:open</ex>.
199 <tags><tab-open-clipboard-url> P</tags>
204 Open (put) a URL based on the current clipboard contents
205 in a new buffer. Works like <k>p</k> but opens a new
206 tab. The new tab is activated if <o>activate</o>
207 contains <str>paste</str>.
218 Open (put) a URL based on the current clipboard contents
219 in a new buffer. The new tab is activated if <o>activate</o>
220 does <em>not</em> contain <str>paste</str>.
226 <tags><![CDATA[<C-x>]]></tags>
228 <spec><oa>count</oa><C-x></spec>
231 Decrements the last number in URL by 1, or by
232 <oa>count</oa> if given. Negative numbers are not
233 supported as trailing numbers in URLs are often preceded
240 <tags><![CDATA[<C-a>]]></tags>
242 <spec><oa>count</oa><C-a></spec>
245 Increments the last number in URL by 1, or by
246 <oa>count</oa> if given.
254 <description short="true">
255 <p>Open home directory. Equivalent to <ex>:open ~/</ex></p>
259 <h2 tag="navigating">Navigating</h2>
262 <tags><![CDATA[H <C-o> CTRL-O :ba :back]]></tags>
263 <spec>:<oa>count</oa>ba<oa>ck</oa> <oa>url</oa></spec>
264 <spec>:ba<oa>ck</oa>!</spec>
265 <spec><oa>count</oa><C-o></spec>
268 Go <oa>count</oa> pages back in the browser history. If
269 <oa>url</oa> is specified go back to the first matching
270 URL. The special version <ex>:back!</ex> goes to the
271 beginning of the browser history.
277 <tags><![CDATA[L <C-i> CTRL-I :fo :fw :forward]]></tags>
278 <spec>:<oa>count</oa>fo<oa>rward</oa> <oa>url</oa></spec>
279 <spec>:fo<oa>rward</oa>!</spec>
280 <spec><oa>count</oa><C-i></spec>
283 Go <oa>count</oa> pages forward in the browser history.
284 If <oa>url</oa> is specified go forward to the first
285 matching URL. The special version <ex>:forward!</ex>
286 goes to the end of the browser history.
292 <tags>:ju :jumps</tags>
293 <spec>:ju<oa>mps</oa></spec>
295 <p>List all jumps, i.e., the current tab's session history.</p>
298 Current history position is marked with <em>></em>.
299 Jump numbers may be used as counts for with
300 <ex>:back</ex> or <ex>:forward</ex>.
308 <description short="true">
309 <p>Go home. Opens the homepage in the current tab.</p>
319 Go home in a new tab. Opens the homepage in a new tab.
320 The new tab is activated if <o>activate</o> contains
328 <spec><oa>count</oa>gu</spec>
329 <description short="true">
330 <p>Go to <oa>count</oa>th parent directory.</p>
333 For example, at the URL
334 <tt>http://www.example.com/dir1/dir2/file.htm</tt>,
335 2<k>gu</k> opens <tt>http://www.example.com/dir1/</tt>.
343 <description short="true">
344 <p>Go to the root of the web site.</p>
347 For example, at the URL
348 <tt>http://www.example.com/dir1/dir2/file.htm</tt>,
349 <k>gU</k> opens <tt>http://www.example.com/</tt>.
354 <h2 tag="reloading">Reloading</h2>
357 <tags><reload> r</tags>
359 <description short="true">
360 <p>Reload the current web page.</p>
365 <tags><full-reload> R</tags>
367 <description short="true">
368 <p>Reload the current web page without using the cache.</p>
373 <tags>:reh :rehash</tags>
374 <spec>:reh<oa>ash</oa> <oa>arg</oa> …</spec>
377 Reload the &dactyl.appName; add-on, including all code, plugins,
378 and configuration. For users running directly from the development
379 repository, this is a good way to update to the latest version or
380 to test your changes.
383 Any arguments supplied are parsed as command-line arguments as
384 specified in <t>startup-options</t>.
387 Not all plugins are designed to cleanly un-apply during a rehash.
388 While official plugins are safe, beware of possible instability
389 if you rehash while running third-party plugins.
395 <tags>:re :reload</tags>
396 <spec>:re<oa>load</oa><oa>!</oa></spec>
399 Reload current web page. If <oa>!</oa> is given, reload
400 without using the cache.
406 <tags>:reloada :reloadall</tags>
407 <spec>:reloada<oa>ll</oa><oa>!</oa></spec>
410 Reload all tabs. If <oa>!</oa> is given, reload without
416 <h2 tag="stopping">Stopping</h2>
419 <tags><![CDATA[<C-c> :st :stop]]></tags>
420 <spec><C-c></spec>
422 <spec>:st<oa>op</oa></spec>
423 <description short="true">
424 <p>Stop loading the current web page.</p>
429 <tags>:stopa :stopall</tags>
430 <spec>:stopa<oa>ll</oa></spec>
431 <description short="true">
432 <p>Stop loading all web pages.</p>
436 <h2 tag="writing save-file">Writing</h2>
439 <tags>:w :write :sav :saveas</tags>
440 <spec>:sav<oa>eas</oa><oa>!</oa> <oa>file</oa></spec>
443 Save current web page to disk. If <oa>file</oa> is omitted, save to
444 the page's default filename. If <oa>file</oa> is a directory or ends
445 with your platform's path separator, save to the page's default
446 filename in that directory. Existing documents will only be
447 overwritten if <oa>!</oa> is given.
453 <spec>:write >> <a>file</a></spec>
456 Appends the current web page to the file <a>file</a>. The given
457 file must already exist.
463 <spec>:write !<a>cmd</a></spec>
466 Writes the current web page to <a>cmd</a> and prints the command's
472 <h2 tag="quitting save-session">Quitting</h2>
475 <tags>:q :quit</tags>
477 <spec>:q<oa>uit</oa></spec>
480 Quit current tab. If this is the last tab in the window,
487 <tags>:qa :qall :quita :quitall</tags>
489 <spec>:quita<oa>ll</oa></spec>
492 Quit &dactyl.appName;, no matter how many tabs/windows
493 are open. The session is not stored.
499 <tags>:wc :wclose :winc :winclose</tags>
500 <spec>:winc<oa>lose</oa></spec>
501 <description short="true">
502 <p>Close the current window.</p>
507 <tags>:winon :winonly</tags>
508 <spec>:winon<oa>ly</oa></spec>
509 <description short="true">
510 <p>Close all windows but the current.</p>
515 <tags>:xa :xall :wq :wqa :wqall</tags>
516 <spec>:wqa<oa>ll</oa></spec>
518 <spec>:xa<oa>ll</oa></spec>
519 <description short="true">
520 <p>Save the current session and quit.</p>
522 Unlike Vim, <ex>:wq</ex> closes the entire window rather
523 than just the current tab.
531 <description short="true">
532 <p>Quit and don't save the session. Works like <ex>:qall</ex>.</p>
539 <description short="true">
541 Quit &dactyl.appName; and save the session. Works like
547 <h2 tag="current-directory">The current directory</h2>
550 <tags>:chd :chdir :cd</tags>
552 <spec>:cd <oa>path</oa></spec>
555 Change the current directory. If <oa>path</oa> is
556 <em>-</em>, change to the previous directory. If it is
557 omitted, change to the home directory.
563 <tags>:pw :pwd</tags>
564 <spec>:pw<oa>d</oa></spec>
565 <description short="true">
566 <p>Print the current directory name.</p>
572 <!-- vim:se sts=4 sw=4 et: -->