ELINKSKEYS(5)

NAME
elinkskeys - ELinks WWW browser key bindings

SYNOPSIS
~/.elinks/elinks.conf

DESCRIPTION
Key bindings for elinks should be placed in a file called ~/.elinks/elinks.conf. Note that any information regarding their format/structure may not be up-to-date. If you will discover that, please feed us with a patch. Key binding statements are of the form:

    bind "keymap" "keystroke" = "action"

where:

keymap
    is main, edit, or menu.

keystroke
    is a case sensitive key, which you can prefix with Ctrl- or Alt-. Ctrl- must be followed by an uppercase key. See below for a list of valid keys.

action
    is what the key should do. The actions available are dependent on the keymap, and are listed separately below.

All words/strings may all be quoted "like so". Backslashes are escape characters, even if not between quotes. Lines beginning with a hash character (#) are comments. Keys can be unbound just by binding them to "none" action. It may be of use if you accidentally type a key often.

KEYS
Valid keys are: alphanumeric characters, punctuation, Enter, Backspace, Tab, Escape, Left, Right, Up, Down, Insert, Delete, Home, End, PageUp, PageDown, F1 to F12. Some keys will need to be quoted or escaped. For example, space can be written as " " (quote space quote), and the quote itself as \" (backslash quote). Backslash can be written as \\ (double backslash).

MAIN KEYMAP ACTIONS
The main keymap is used for general browsing.

add-bookmark
    Open a dialog box to add a new bookmark.

back
    Return to the previous page.

bookmark-manager
    Open the bookmark manager dialog.

cookies-load
    ??? Reload cookies file. (ELinks only) [pasky, shouldn't this be load-cookies?]

copy-clipboard
    Copy the current link to the clipboard.

document-info
    Show some information about the current page.

down
    Move cursor downwards.

download
    Start downloading the current link.

end Go to the end of the page.

enter
    Follow the current link.

file-menu
    Open the File menu.

find-next
    Find the next occurrence of the current search text.

find-next-back
    Find the next occurrence of the current search text, in reverse.

goto-url
    Open a "Go to URL" dialog box.

goto-url-current
    Open a "Go to URL" dialog box containing the current URL.

goto-url-current-link
    Open a "Go to URL" dialog box containing the current link.

header-info
    Show the current page header information.

home
    Go to the start of the page.

link-menu
    Activate the contextual link menu.

lua-console
    Open a Lua Console dialog box. Only available if Lua scripting support has been compiled in (Links-Lua and ELinks).

menu
    Activate the menu.

next-frame
    Move to the next frame.

open-new-window
    Open a new instace of ELinks in a new window.

open-link-in-new-window
    Open the current link in a new instance of ELinks in a new window.

page-down
    Move downwards by a page.

page-up
    Move upwards by a page.

paste-clipboard
    Paste text from the clipboard.

previous-frame
    Move to the previous frame.

quit
    Open a quit confirmation dialog box.

really-quit
    Quit without confirmation.

reload
    Reload the current page.

scroll-down
    Scroll the viewing window downwards.

scroll-left
    Scroll the viewing window to the left.

scroll-right
    Scroll the viewing window to the right.

scroll-up
    Scroll the viewing window upwards.

search
    Search for some text.

search-back
    Search for some text, in reverse.

toggle-display-images
    Toggle whether to display links to images.

toggle-display-tables
    Toggle whether to render tables.

toggle-html-plain
    Toggles between rendering the current page as HTML or plaintext.

unback
    Go forwards in unhistory. (ELinks only)

up  Move cursor upwards.

view-image
    View the image under the cursor.

zoom-frame
    Show the current frame using the entire screen.

EDIT KEYMAP ACTIONS
The edit keymap is used for editing text fields.

up

down

left

right

home

end

backspace

delete

kill-to-bol
    Delete text from cursor to beginning of line.

kill-to-eol
    Delete text from cursor to end of line.

auto-complete

enter

copy-clipboard

cut-clipboard

paste-clipboard

edit
    Edit the current textarea in an external text editor. (ELinks only)

MENU KEYMAP ACTIONS
The menu keymap is used for navigating menus.

left

right

up

down

home

end

page-up

page-down

DEFAULT BINDINGS
The default bindings are shown below. Any bindings in elinks.conf will override these. This list is given as an example, and may not be up to date.
bind main PageDown      page-down
bind main " "           page-down
bind main Ctrl-F        page-down
bind main PageUp        page-up
bind main b             page-up
bind main B             page-up
bind main Ctrl-B        page-up
bind main Down          down
bind main Up            up
bind main Ctrl-Insert   copy-clipboard
bind main Ctrl-C        copy-clipboard
bind main Insert        scroll-up
bind main Ctrl-P        scroll-up
bind main Delete        scroll-down
bind main Ctrl-N        scroll-down
bind main [             scroll-left
bind main ]             scroll-right
bind main Home          home
bind main Ctrl-A        home
bind main End           end
bind main Ctrl-E        end
bind main Right         enter
bind main Enter         enter
bind main Left          back
bind main d             download
bind main D             download
bind main /             search
bind main ?             search-back
bind main n             find-next
bind main N             find-next-back
bind main f             zoom-frame
bind main F             zoom-frame
bind main Ctrl-R        reload
bind main g             goto-url
bind main G             goto-url-current
bind main a             add-bookmark
bind main A             add-bookmark
bind main s             bookmark-manager
bind main S             bookmark-manager
bind main q             quit
bind main Q             really-quit
bind main =             document-info
bind main |             header-info
bind main \\            toggle-html-plain
bind main *             toggle-display-images
bind main Tab           next-frame
bind main Escape        menu
bind main F9            menu
bind main F10           file-menu
bind edit Left          left
bind edit Right         right
bind edit Home          home
bind edit Ctrl-A        home
bind edit Up            up
bind edit Down          down
bind edit End           end
bind edit Ctrl-E        end
bind edit Ctrl-Insert   copy-clipboard
bind edit Ctrl-B        copy-clipboard
bind edit Ctrl-X        cut-clipboard
bind edit Ctrl-V        paste-clipboard
bind edit Enter         enter
bind edit Backspace     backspace
bind edit Ctrl-H        backspace
bind edit Delete        delete
bind edit Ctrl-D        delete
bind edit Ctrl-U        kill-to-bol
bind edit Ctrl-K        kill-to-eol
bind edit Ctrl-W        auto-complete
bind menu Left          left
bind menu Right         right
bind menu Home          home
bind menu Ctrl-A        home
bind menu Up            up
bind menu Down          down
bind menu End           end
bind menu Ctrl-E        end
bind menu Enter         enter
bind menu PageDown      page-down
bind menu Ctrl-F        page-down
bind menu PageUp        page-up
bind menu Ctrl-B        page-up
# ELinks only
bind main l             link-menu
bind main L             link-menu
bind main u             unback
bind main U             unback
bind main Ctrl-K        cookies-load
bind edit F4            edit
bind edit Ctrl-T        edit
# Links-Lua and ELinks
bind main ,             lua-console

FILES
/usr/local/etc/elinks/elinks.conf Site-wide configuration file. ~/.elinks/elinks.conf Per-user configuration file, loaded after site-wide configuration.

AUTHOR
This manual page was finally written by Peter Wang (one and a half years after writing the binding code), using excerpts by David Mediavilla. You can thank Petr Baudis for the subtle requests for documentation. Updated by Zas.

SEE ALSO
elinks(1), elinks.conf(5)