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="opening">Opening web pages</h2>
18 <tags>o :o :open</tags>
19 <spec>:o<oa>pen</oa> <oa>args</oa></spec>
23 Open a single URL in the current tab, or multiple URLs
24 in the current tab and background tabs. URLs may be
25 separated with <o>urlseparator</o>, in which case the
26 first URL is opened in the current tab and the rest are
27 opened in new background tabs.
31 Each URL may be one of the following:
36 A local filename, if it begins with <em>/</em>,
37 <em>./</em>, or <em>~/</em> and the specified file
42 A search or bookmark keyword, or a search engine
43 name, followed by search arguments.
45 <example><ex>:open wikipedia Linus Torvalds</ex></example>
47 Search engines can be edited via
48 <ex>:dialog searchengines</ex> and search
49 keywords may be added by right clicking any
50 search box and selecting <str>Add a Keyword for
56 Any search string which does not look like a URL or
57 hostname, which will be passed to the default
58 search engine (see <o>defsearch</o>).
60 <example><ex>:open Linus Torvalds</ex></example>
63 Any other value is passed directly to &dactyl.host; and
64 must be a valid URL or hostname.
69 <ex>:open</ex> provides powerful URL completion from
70 several possible sources, which can be adjusted via the
71 <o>complete</o> option.
77 <tags>t :t :tabopen :tabnew</tags>
78 <spec>:tabopen<oa>!</oa> <oa>args</oa></spec>
82 Like <ex>:open</ex>, but all arguments are opened in new
83 tabs. The first new tab is activated if <o>activate</o>
84 contains <str>tabopen</str> or <oa>!</oa> is provided.
92 <description short="true">
94 Open an <ex>:open</ex> prompt followed by the current URL.
102 <description short="true">
104 Open a <ex>:tabopen</ex> prompt followed by the current URL.
112 <description short="true">
113 <p>Open a search prompt.</p>
120 <description short="true">
121 <p>Open a search prompt for a new tab.</p>
126 <tags>:tabdu :tabduplicate</tags>
127 <spec>:<oa>count</oa>tabdu<oa>plicate</oa><oa>!</oa></spec>
130 Duplicates current tab <oa>count</oa> times. The first
131 new tab is activated if <o>activate</o> contains
132 <str>tabopen</str> or <oa>!</oa> is provided.
138 <tags>w :winopen :wopen</tags>
139 <spec>:wino<oa>pen</oa><oa>!</oa> <oa>args</oa></spec>
143 Like <ex>:tabopen</ex>, but all arguments are opened in
152 <description short="true">
154 Open a <ex>:winopen</ex> prompt followed by the current URL.
160 <tags><![CDATA[<open-clipboard-url> <MiddleMouse> p]]></tags>
165 Open (put) a URL based on the current clipboard
166 contents, or, on X11 systems, the currently selected
167 text. All white space is stripped from the selection and
168 it is opened in the same manner as <ex>:open</ex>.
174 <tags><tab-open-clipboard-url> P</tags>
179 Open (put) a URL based on the current clipboard contents
180 in a new buffer. Works like <k>p</k> but opens a new
181 tab. The new tab is activated if <o>activate</o>
182 contains <str>paste</str>.
193 Open (put) a URL based on the current clipboard contents
194 in a new buffer. The new tab is activated if <o>activate</o>
195 does <em>not</em> contain <str>paste</str>.
201 <tags><![CDATA[<decrement-url-path> <C-x>]]></tags>
203 <spec><oa>count</oa><C-x></spec>
206 Decrements the last number in URL by 1, or by
207 <oa>count</oa> if given. Negative numbers are not
208 supported as trailing numbers in URLs are often preceded
215 <tags><![CDATA[<increment-url-path> <C-a>]]></tags>
217 <spec><oa>count</oa><C-a></spec>
220 Increments the last number in URL by 1, or by
221 <oa>count</oa> if given.
226 <h2 tag="history">History</h2>
229 <tags><![CDATA[<C-o>]]></tags>
231 <spec><oa>count</oa><![CDATA[<C-o>]]></spec>
234 Go to an older position in the jump list.
235 If <oa>count</oa> is specified, jump <oa>count</oa> positions backward.
241 <tags><![CDATA[<C-i>]]></tags>
243 <spec><oa>count</oa><![CDATA[<C-i>]]></spec>
246 Go to a newer position in the jump list.
247 If <oa>count</oa> is specified, jump <oa>count</oa> positions forward.
253 <tags>:ju :jumps</tags>
255 <spec>:ju<oa>mps</oa></spec>
258 Display the jump list.
259 The jump numbers shown are suitable as arguments to <k name="C-o"/>
266 <tags><![CDATA[<M-Left> <A-Left> H]]></tags>
268 <spec>[count]H</spec>
271 Go back in the browser history. If <oa>count</oa> is specified, go
272 back <oa>count</oa> pages.
278 <tags><![CDATA[<M-Right> <A-Right> L]]></tags>
280 <spec><oa>count</oa>L</spec>
283 Go forward in the browser history. If <oa>count</oa> is specified,
284 go forward <oa>count</oa> pages.
290 <tags>:ba :back</tags>
291 <spec>:<oa>count</oa>ba<oa>ck</oa> <oa>url</oa></spec>
292 <spec>:<oa>count</oa>ba<oa>ck</oa>!</spec>
295 Go back in the browser history. If <oa>count</oa> is specified, go
296 back <oa>count</oa> pages.
299 The special version <ex>:back!</ex> goes to the beginning of the browser history.
305 <tags>:fw :fo :forward</tags>
306 <spec>:<oa>count</oa>fo<oa>rward</oa> <oa>url</oa></spec>
307 <spec>:<oa>count</oa>fo<oa>rward</oa>!</spec>
310 Go forward in the browser history. If <oa>count</oa> is specified,
311 go forward <oa>count</oa> pages.
314 The special version <ex>:forward!</ex> goes to the end of the browser history.
320 <tags><![CDATA[[d]]></tags>
321 <spec><oa>count</oa>[d</spec>
324 Go to the <oa>count</oa>th previous domain in the history stack.
330 <tags><![CDATA[]d]]></tags>
331 <spec><oa>count</oa>]d</spec>
334 Go to the <oa>count</oa>th next domain in the history stack.
340 <tags>:hs :hist :history</tags>
341 <spec>:hist<oa>ory</oa><oa>!</oa> <oa>filter</oa></spec>
344 Show recently visited URLs. Opens the message window at the bottom of the screen
345 with all history items whose page titles or URLs match
350 The special version <ex>:history!</ex> works the same as
351 <ex>:history</ex> except that it opens all matching
352 pages in new tabs rather than listing them.
355 <p>The pages may also be filtered via the following options,</p>
357 <dl dt="width: 8em;">
360 The maximum number of items to list or open
361 (short name <em>-m</em>).
365 The sort order of the results
366 (short name <em>-s</em>).
372 <h2 tag="navigating">Navigating</h2>
375 <tags><![CDATA[<open-home-directory> ~]]></tags>
377 <description short="true">
378 <p>Open home directory. Equivalent to <ex>:open ~/</ex></p>
383 <tags><![CDATA[<open-homepage> gh]]></tags>
385 <description short="true">
386 <p>Go home. Opens the homepage in the current tab.</p>
391 <tags><![CDATA[<tab-open-homepage> gH]]></tags>
396 Go home in a new tab. Opens the homepage in a new tab.
397 The new tab is activated if <o>activate</o> contains
404 <tags><![CDATA[<open-parent-path> gu]]></tags>
405 <spec><oa>count</oa>gu</spec>
406 <description short="true">
407 <p>Go to <oa>count</oa>th parent directory.</p>
410 For example, at the URL
411 <tt>http://www.example.com/dir1/dir2/file.htm</tt>,
412 2<k>gu</k> opens <tt>http://www.example.com/dir1/</tt>.
418 <tags><![CDATA[<open-root-path> gU]]></tags>
420 <description short="true">
421 <p>Go to the root of the web site.</p>
424 For example, at the URL
425 <tt>http://www.example.com/dir1/dir2/file.htm</tt>,
426 <k>gU</k> opens <tt>http://www.example.com/</tt>.
431 <h2 tag="reloading">Reloading</h2>
434 <tags><reload> r</tags>
436 <description short="true">
437 <p>Reload the current web page.</p>
442 <tags><full-reload> R</tags>
444 <description short="true">
445 <p>Reload the current web page without using the cache.</p>
450 <tags>:re :reload</tags>
451 <spec>:re<oa>load</oa><oa>!</oa></spec>
454 Reload current web page. If <oa>!</oa> is given, reload
455 without using the cache.
461 <tags>:reloada :reloadall</tags>
462 <spec>:reloada<oa>ll</oa><oa>!</oa></spec>
465 Reload all tabs. If <oa>!</oa> is given, reload without
471 <h2 tag="stopping">Stopping</h2>
474 <tags><![CDATA[<stop-load> <C-c> :st :stop]]></tags>
475 <spec><C-c></spec>
477 <spec>:st<oa>op</oa></spec>
478 <description short="true">
479 <p>Stop loading the current web page.</p>
484 <tags>:stopa :stopall</tags>
485 <spec>:stopa<oa>ll</oa></spec>
486 <description short="true">
487 <p>Stop loading all web pages.</p>
491 <h2 tag="writing save-file">Writing</h2>
494 <tags>:w :write :sav :saveas</tags>
495 <spec>:sav<oa>eas</oa><oa>!</oa> <oa>file</oa></spec>
498 Save current web page to disk. If <oa>file</oa> is omitted, save to
499 the page's default filename. If <oa>file</oa> is a directory or ends
500 with your platform's path separator, save to the page's default
501 filename in that directory. Existing documents will only be
502 overwritten if <oa>!</oa> is given.
508 <spec>:write >> <a>file</a></spec>
511 Appends the current web page to the file <a>file</a>. The given
512 file must already exist.
518 <spec>:write !<a>cmd</a></spec>
521 Writes the current web page to <a>cmd</a> and prints the command's
527 <h2 tag="quitting save-session">Quitting</h2>
530 <tags>ZQ :x :exit</tags>
532 <spec>:exit<oa>!</oa></spec>
535 Quit &dactyl.appName;, no matter how many tabs/windows are open.
536 The session is not stored. Use <oa>!</oa> to forcibly quit.
542 <tags>:q :quit</tags>
544 <spec>:q<oa>uit</oa></spec>
547 Quit current tab. If this is the last tab in the window,
554 <tags>:qa :qall :quita :quitall</tags>
556 <spec>:quita<oa>ll</oa></spec>
559 Close the current &dactyl.appName; window, no matter how
566 <tags>:wc :wclose :winc :winclose</tags>
567 <spec>:winc<oa>lose</oa></spec>
568 <description short="true">
569 <p>Close the current window.</p>
574 <tags>:winon :winonly</tags>
575 <spec>:winon<oa>ly</oa></spec>
576 <description short="true">
577 <p>Close all windows but the current.</p>
582 <tags>ZZ :xa :xall :wq :wqa :wqall</tags>
583 <spec>:wqa<oa>ll</oa></spec>
585 <spec>:xa<oa>ll</oa></spec>
586 <description short="true">
587 <p>Save the current session and quit.</p>
589 Unlike Vim, <ex>:wq</ex> closes the entire window rather
590 than just the current tab.
595 <h2 tag="current-directory">The current directory</h2>
598 <tags>:chd :chdir :cd</tags>
600 <spec>:cd <oa>path</oa></spec>
603 Change the current directory. If <oa>path</oa> is
604 <em>-</em>, change to the previous directory. If it is
605 omitted, change to the home directory.
611 <tags>:pw :pwd</tags>
612 <spec>:pw<oa>d</oa></spec>
613 <description short="true">
614 <p>Print the current directory name.</p>
620 <!-- vim:se sts=4 sw=4 et: -->