elinkskeys

ELINKSKEYS(5)                                                    ELINKSKEYS(5)



NAME
       elinkskeys - keybindings for ELinks

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.

        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.

        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.

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

        left

        right

        up

        down

        home

        end

        page-up

        page-down

NAVIGATION KEYS
       You may prefix each of these keys with a number, telling its repeat
       count (how many times to do it).  You  can  also  re-bind  keys, see
       elinkskeys(5) for documentation and a more complete list of keys bound
       by default.

        PGDN  page down

        Space page down

        PGUP  page up

        b     page up

        B     page up

        DOWN  next link/down

        UP    prev link/up

        ^INS  copy to clipboard

        ^C    copy to clipboard

        INS   scroll up

        ^P    scroll up

        DEL   scroll down

        ^N    scroll down

        [     scroll left

        ]     scroll right

        HOME  home

        END   end of page

        RIGHT enter link/press button

        ENTER enter link/press button

        LEFT  go back

        d     download link

        D     download link

        F4    edit textarea in external editor (broken)

        ^T    edit textarea in external editor (broken)

        /     search in the page

        ?     search back in the page

        n     find next match

        N     find next match backwards

        f     zoom actual frame

        F     zoom actual frame

        ^R    reload page

        g     go to URL

        G     go to the current URL

        a     add a new bookmark

        A     add a new bookmark

        s     bookmark manager

        S     bookmark manager

        ^K    reload cookies from ~/.elinks/cookies

        q     quit

        Q     quit

        =     document information

        |     header information

        \     toggle HTML source/rendered view

        *     toggle display of images

        TAB   next frame

        ESC   menu/escape

        F9    menu

        F10   file menu

EDITING KEYS
       The following keys can be used while editing a line/jumping to a URL:

        RIGHT move right

        LEFT  move left

        HOME  jump to the beginning

        ^A    jump to the beginning

        END   jump to the end

        ^E    jump to the end

        ^INS  copy to clipboard

        ^B    copy to clipboard

        ^X    cut to clipboard

        ^V    paste from clipboard

        ENTER enter line

        BACKSPACE
              delete back character

        ^H    delete back character

        DEL   delete character

        ^D    delete character

        ^U    delete from beginning of the line

        ^K    delete to the end of the line

        ^W    auto complete line

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" "v" = "view-image"
       bind "main" "l" = "jump-to-link"
       bind "main" "L" = "link-menu"
       bind "main" "F10" = "file-menu"
       bind "main" "F9" = "menu"
       bind "main" "Escape" = "menu"
       bind "main" "Tab" = "next-frame"
       bind "main" "*" = "toggle-display-images"
       bind "main" "." = "toggle-numbered-links"
       bind "main" "\\" = "toggle-html-plain"
       bind "main" "<" = "tab-prev"
       bind "main" ">" = "tab-next"
       bind "main" "c" = "tab-close"
       bind "main" "|" = "header-info"
       bind "main" "=" = "document-info"
       bind "main" "Q" = "really-quit"
       bind "main" "q" = "quit"
       bind "main" "Ctrl-K" = "cookies-load"
       bind "main" "k" = "keybinding-manager"
       bind "main" "o" = "options-manager"
       bind "main" "h" = "history-manager"
       bind "main" "S" = "bookmark-manager"
       bind "main" "s" = "bookmark-manager"
       bind "main" "A" = "add-bookmark-link"
       bind "main" "a" = "add-bookmark"
       bind "main" "M" = "goto-url-home"
       bind "main" "m" = "goto-url-home"
       bind "main" "H" = "goto-url-home"
       bind "main" "G" = "goto-url-current"
       bind "main" "g" = "goto-url"
       bind "main" "E" = "goto-url-current-link"
       bind "main" "Ctrl-R" = "reload"
       bind "main" "F" = "zoom-frame"
       bind "main" "f" = "zoom-frame"
       bind "main" "N" = "find-next-back"
       bind "main" "n" = "find-next"
       bind "main" "?" = "search-back"
       bind "main" "/" = "search"
       bind "main" "z" = "abort-connection"
       bind "main" "R" = "resume-download"
       bind "main" "r" = "resume-download"
       bind "main" "D" = "download"
       bind "main" "d" = "download"
       bind "main" "U" = "unback"
       bind "main" "u" = "unback"
       bind "main" "Left" = "back"
       bind "main" "x" = "enter-reload"
       bind "main" "Ctrl-Enter" = "enter-reload"
       bind "main" "Ctrl-Right" = "enter-reload"
       bind "main" "Enter" = "enter"
       bind "main" "Right" = "enter"
       bind "main" "Ctrl-E" = "end"
       bind "main" "End" = "end"
       bind "main" "Ctrl-A" = "home"
       bind "main" "Home" = "home"
       bind "main" "}" = "scroll-right"
       bind "main" "{" = "scroll-left"
       bind "main" "]" = "scroll-right"
       bind "main" "[" = "scroll-left"
       bind "main" "Ctrl-N" = "scroll-down"
       bind "main" "Delete" = "scroll-down"
       bind "main" "Ctrl-P" = "scroll-up"
       bind "main" "Insert" = "scroll-up"
       bind "main" "Ctrl-C" = "copy-clipboard"
       bind "main" "Ctrl-Insert" = "copy-clipboard"
       bind "main" "Up" = "up"
       bind "main" "Down" = "down"
       bind "main" "Ctrl-B" = "page-up"
       bind "main" "B" = "page-up"
       bind "main" "b" = "page-up"
       bind "main" "PageUp" = "page-up"
       bind "main" "Ctrl-F" = "page-down"
       bind "main" " " = "page-down"
       bind "main" "PageDown" = "page-down"

       bind "edit" "Ctrl-R" = "auto-complete-unambiguous"
       bind "edit" "Ctrl-W" = "auto-complete"
       bind "edit" "Ctrl-K" = "kill-to-eol"
       bind "edit" "Ctrl-U" = "kill-to-bol"
       bind "edit" "Ctrl-D" = "delete"
       bind "edit" "Delete" = "delete"
       bind "edit" "Ctrl-H" = "backspace"
       bind "edit" "Backspace" = "backspace"
       bind "edit" "Enter" = "enter"
       bind "edit" "Ctrl-V" = "paste-clipboard"
       bind "edit" "Ctrl-X" = "cut-clipboard"
       bind "edit" "Ctrl-C" = "copy-clipboard"
       bind "edit" "Ctrl-Insert" = "copy-clipboard"
       bind "edit" "Ctrl-T" = "edit"
       bind "edit" "F4" = "edit"
       bind "edit" "Ctrl-E" = "end"
       bind "edit" "End" = "end"
       bind "edit" "Down" = "down"
       bind "edit" "Up" = "up"
       bind "edit" "Ctrl-A" = "home"
       bind "edit" "Home" = "home"
       bind "edit" "Right" = "right"
       bind "edit" "Left" = "left"

       bind "menu" "Ctrl-B" = "page-up"
       bind "menu" "PageUp" = "page-up"
       bind "menu" "Ctrl-F" = "page-down"
       bind "menu" "PageDown" = "page-down"
       bind "menu" "Enter" = "enter"
       bind "menu" "Ctrl-E" = "end"
       bind "menu" "End" = "end"
       bind "menu" "Down" = "down"
       bind "menu" "Up" = "up"
       bind "menu" "Ctrl-A" = "home"
       bind "menu" "Home" = "home"
       bind "menu" "Right" = "right"
       bind "menu" "Left" = "left"

       # ELinks with Lua support
       bind "main" ","     = "lua-console"

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. Moved to docbook format and cleaned up
       by Jonas.

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



                                 15 June 2003                    ELINKSKEYS(5)