elinkskeys

TriggerTek Logo
abcdefghijklmnopqrstuvwxyz_
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	 for-
       mat/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  plain-
	      text.

	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 Mediav-
       illa.  You can thank Petr Baudis for the subtle requests for  documen-
       tation.	Updated	 by  Zas.  Moved  to docbook format and cleaned up by
       Jonas.

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



				 15 June 2003			ELINKSKEYS(5)