browsing.xml

surfingbrowsing
Browsing

Contents

  1. Bypassing Pentadactyl
  2. Opening web pages
  3. Navigating
  4. Reloading
  5. Stopping
  6. Writing
  7. Quitting
  8. The current directory

bypassing-pentadactyl
Bypassing Pentadactyl

Pentadactyl overrides nearly all Firefox keys in order to make browsing more pleasant for Vim users. On the occasions when you want to bypass Pentadactyl's key handling and pass keys directly to Firefox or to a web page, you have several options:
<pass-next-key-builtin><A-b>
<A-b>

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

send-key<pass-next-key><C-v>CTRL-V
<C-v>

Pass the next key press directly to Firefox.

pass-through<pass-all-keys><C-z>CTRL-Z
<C-z>

Pass all keys except for <Esc> directly to Firefox. When <Esc> 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
Opening web pages

o:o:open
:o[pen] [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.

    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').

  4. Any other value is passed directly to Firefox 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
:[count]tabdu[plicate][!]

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
:wino[pen][!] [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.

<open-clipboard-url><MiddleMouse>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.

<decrement-url-path><C-x>
[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.

<increment-url-path><C-a>
[count]<C-a>

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

<open-home-directory>~
~

Open home directory. Equivalent to :open ~/

navigating
Navigating

H<C-o>CTRL-O:ba:back
:[count]ba[ck] [url]
:ba[ck]!
[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.

L<C-i>CTRL-I:fo:fw:forward
:[count]fo[rward] [url]
:fo[rward]!
[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
:ju[mps]

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.

<open-homepage>gh
gh

Go home. Opens the homepage in the current tab.

<tab-open-homepage>gH
gH

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

<open-parent-path>gu
[count]gu

Go to [count]th parent directory.

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

<open-root-path>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
Reloading

<reload>r
r

Reload the current web page.

<full-reload>R
R

Reload the current web page without using the cache.

:re:reload
:re[load][!]

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

:reloada:reloadall
:reloada[ll][!]

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

stopping
Stopping

<stop-load><C-c>:st:stop
<C-c>
:st[op]

Stop loading the current web page.

:stopa:stopall
:stopa[ll]

Stop loading all web pages.

writingsave-file
Writing

:w:write:sav:saveas
:sav[eas][!] [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.

quittingsave-session
Quitting

ZQ:x:exit
:exit[!]

Quit Pentadactyl, no matter how many tabs/windows are open. The session is not stored. Use [!] to forcibly quit.

:q:quit
:q[uit]

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

:qa:qall:quita:quitall
:quita[ll]

Close the current Pentadactyl window, no matter how many tabs are open.

:wc:wclose:winc:winclose
:winc[lose]

Close the current window.

:winon:winonly
:winon[ly]

Close all windows but the current.

ZZ:xa:xall:wq:wqa:wqall
:wqa[ll]
:xa[ll]

Save the current session and quit.

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

current-directory
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
:pw[d]

Print the current directory name.