Browsing

Bypassing &dactyl.appName;

&dactyl.appName; overrides nearly all &dactyl.host; keys in order to make browsing more pleasant for Vim users. On the occasions when you want to bypass &dactyl.appName;'s key handling and pass keys directly to &dactyl.host; or to a web page, you have several options: ]]> ]]>

Process the next key as a builtin mapping, ignoring any user defined mappings and passkeys settings.

CTRL-V]]> ]]>

Pass the next key press directly to &dactyl.host;.

CTRL-Z]]> ]]>

Pass all keys except for directly to &dactyl.host;. When is pressed, resume normal key handling. This is especially useful for web sites which make heavy use of key bindings.

See also passkeys and passunknown for ways to permanently pass all or particular keys under certain conditions.

Opening web pages

o :o :open :open args o

Open a single URL in the current tab, or multiple URLs in the current tab and background tabs. URLs may be separated with urlseparator, in which case the first URL is opened in the current tab and the rest are opened in new background tabs.

Each URL may be one of the following:

  1. A local filename, if it begins with /, ./, or ~/ and the specified file exists.

  2. A search or bookmark keyword, or a search engine name, followed by search arguments.

    :open wikipedia Linus Torvalds

    Search engines can be edited via :dialog searchengines and search keywords may be added by right clicking any search box and selecting Add a Keyword for this Search.

  3. Any search string which does not look like a URL or hostname, which will be passed to the default search engine (see defsearch).

    :open Linus Torvalds
  4. Any other value is passed directly to &dactyl.host; and must be a valid URL or hostname.

:open provides powerful URL completion from several possible sources, which can be adjusted via the complete option.

t :t :tabopen :tabnew :tabopen! args t

Like :open, but all arguments are opened in new tabs. The first new tab is activated if activate contains tabopen or ! is provided.

T T

Open a :tabopen prompt followed by the current URL.

:tabdu :tabduplicate :counttabduplicate!

Duplicates current tab count times. The first new tab is activated if activate contains tabopen or ! is provided.

O O

Open an :open prompt followed by the current URL.

w :winopen :wopen :winopen! args w

Like :tabopen, but all arguments are opened in a single new window.

W W

Open a :winopen prompt followed by the current URL.

p]]> p

Open (put) a URL based on the current clipboard contents, or, on X11 systems, the currently selected text. All white space is stripped from the selection and it is opened in the same manner as :open.

<tab-open-clipboard-url> P P

Open (put) a URL based on the current clipboard contents in a new buffer. Works like p but opens a new tab. The new tab is activated if activate contains paste.

gP gP

Open (put) a URL based on the current clipboard contents in a new buffer. The new tab is activated if activate does not contain paste.

]]> count<C-x>

Decrements the last number in URL by 1, or by count if given. Negative numbers are not supported as trailing numbers in URLs are often preceded by hyphens.

]]> count<C-a>

Increments the last number in URL by 1, or by count if given.

~]]> ~

Open home directory. Equivalent to :open ~/

Navigating

CTRL-O :ba :back]]> :countback url :back! count<C-o>

Go count pages back in the browser history. If url is specified go back to the first matching URL. The special version :back! goes to the beginning of the browser history.

CTRL-I :fo :fw :forward]]> :countforward url :forward! count<C-i>

Go count pages forward in the browser history. If url is specified go forward to the first matching URL. The special version :forward! goes to the end of the browser history.

:ju :jumps :jumps

List all jumps, i.e., the current tab's session history.

Current history position is marked with >. Jump numbers may be used as counts for :back or :forward.

gh]]> gh

Go home. Opens the homepage in the current tab.

 gH]]> gH

Go home in a new tab. Opens the homepage in a new tab. The new tab is activated if activate contains homepage.

gu]]> countgu

Go to countth parent directory.

For example, at the URL http://www.example.com/dir1/dir2/file.htm, 2gu opens http://www.example.com/dir1/.

gU]]> gU

Go to the root of the web site.

For example, at the URL http://www.example.com/dir1/dir2/file.htm, gU opens http://www.example.com/.

Reloading

<reload> r r

Reload the current web page.

 <full-reload> R R

Reload the current web page without using the cache.

 :re :reload :reload!

Reload current web page. If ! is given, reload without using the cache.

:reloada :reloadall :reloadall!

Reload all tabs. If ! is given, reload without using the cache.

Stopping

:st :stop]]> <C-c> :stop

Stop loading the current web page.

 :stopa :stopall :stopall

Stop loading all web pages.

Writing

:w :write :sav :saveas :saveas! file

Save current web page to disk. If file is omitted, save to the page's default filename. If file is a directory or ends with your platform's path separator, save to the page's default filename in that directory. Existing documents will only be overwritten if ! is given.

:write >> file

Appends the current web page to the file file. The given file must already exist.

:write !cmd

Writes the current web page to cmd and prints the command's output.

Quitting

ZQ :x :exit :exit!

Quit &dactyl.appName;, no matter how many tabs/windows are open. The session is not stored. Use ! to forcibly quit.

:q :quit :quit

Quit current tab. If this is the last tab in the window, close the window.

:qa :qall :quita :quitall :quitall

Close the current &dactyl.appName; window, no matter how many tabs are open.

:wc :wclose :winc :winclose :winclose

Close the current window.

 :winon :winonly :winonly

Close all windows but the current.

 ZZ :xa :xall :wq :wqa :wqall :wqall :xall

Save the current session and quit.

Unlike Vim, :wq closes the entire window rather than just the current tab.

The current directory

:chd :chdir :cd :cd path

Change the current directory. If path is -, change to the previous directory. If it is omitted, change to the home directory.

:pw :pwd :pwd

Print the current directory name.