3 .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
5 .\" Manual: ELinks keybindings
6 .\" Source: ELinks 0.12pre1
8 .TH "ELINKSKEYS" "5" "06/30/2008" "ELinks 0.12pre1" "ELinks keybindings"
9 .\" disable hyphenation
11 .\" disable justification (adjust text to left margin only)
14 elinkskeys \- keybindings for ELinks
16 Information on how to configure keybinding and overview of the default keybindings.
19 Key binding for elinks should be placed in the file ~/.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.
21 Key binding statements are of the form:
26 bind <keymap> <keystroke> = <action>
37 \fImenu\fR. The main keymap is used for general browsing. The edit keymap is used for editing text fields. The menu keymap is used for navigating menus.
42 is a case sensitive key, which you can prefix with
46 must be followed by an uppercase key. See below for a list of valid keys.
51 is what the key should do. The actions available are dependent on the keymap, and are listed separately below.
53 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.
55 Keys can be unbound just by binding them to the special \fInone\fR action. It may be of use if you accidentally type a key often.
57 .SH "EXAMPLE BINDINGS"
58 Some sample keybindings:
63 bind "main" "v" = "view\-image"
64 bind "main" "l" = "jump\-to\-link"
65 bind "main" "L" = "link\-menu"
66 bind "main" "F10" = "file\-menu"
67 bind "main" "F9" = "menu"
68 bind "main" "Escape" = "menu"
69 bind "edit" "Ctrl\-R" = "auto\-complete\-unambiguous"
70 bind "edit" "Ctrl\-W" = "auto\-complete"
71 bind "edit" "Ctrl\-K" = "kill\-to\-eol"
72 bind "menu" "Ctrl\-B" = "page\-up"
73 bind "menu" "PageUp" = "page\-up"
74 bind "menu" "Ctrl\-F" = "page\-down"
75 bind "menu" "PageDown" = "page\-down"
76 # ELinks with Lua support
77 bind "main" "," = "lua\-console"
81 Valid keys are: alphanumeric characters, punctuation, \fIEnter\fR, \fIBackspace\fR, \fITab\fR, \fIEscape\fR, \fILeft\fR, \fIRight\fR, \fIUp\fR, \fIDown\fR, \fIInsert\fR, \fIDelete\fR, \fIHome\fR, \fIEnd\fR, \fIPageUp\fR, \fIPageDown\fR, \fIF1\fR to \fIF12\fR.
83 Some keys will need to be quoted or escaped. For example, space can be written as " " (quote space quote), and the quote itself as \e" (backslash quote). Backslash can be written as \e\e (double backslash).
100 Add a new bookmark using current link.
105 Bookmark all open tabs.
110 Open authentication manager.
115 Backspace the last entered digit of the current prefix.
120 Open bookmark manager.
130 Free unused cache entries.
145 Copy text to clipboard.
150 Show information about the current page.
155 Open download manager.
160 Enter ex\-mode (command line).
170 Find the next occurrence of the current search text.
175 Find the previous occurrence of the current search text.
180 Forget authentication credentials.
185 Open form history manager.
188 frame\-external\-command
190 Pass URI of current frame to external command.
195 Maximize the current frame.
200 Move to the next frame.
205 Move to the previous frame.
210 Open "Go to URL" dialog box.
215 Open "Go to URL" dialog box containing the current URL.
218 goto\-url\-current\-link
220 Open "Go to URL" dialog box containing the current link URL.
230 Show information about the current page protocol headers.
235 Open history manager.
240 Return to the previous document in history.
243 history\-move\-forward
245 Go forward in history.
255 Open keybinding manager.
258 kill\-backgrounded\-connections
260 Kill all backgrounded connections.
265 Download the current link.
268 link\-download\-image
270 Download the current image.
273 link\-download\-resume
275 Attempt to resume download of the current link.
278 link\-external\-command
280 Pass URI of current link to external command.
285 Follow the current link.
290 Follow the current link, forcing reload of the target.
295 Open the link context menu.
300 Open the form fields menu.
310 Go at a specified mark.
333 move\-cursor\-line\-start
335 Move cursor to the start of the line.
350 Move to the end of the document.
353 move\-document\-start
355 Move to the start of the document.
363 move\-link\-down\-line
365 Move to the next line with a link.
373 move\-link\-left\-line
375 Move one link left or to the previous link.
380 Move to the next link.
385 Move to the previous link.
393 move\-link\-right\-line
395 Move one link right or to the next link.
405 Move to the previous line with a link.
410 Move downwards by a page.
415 Move upwards by a page.
418 open\-link\-in\-new\-tab
420 Open the current link in a new tab.
423 open\-link\-in\-new\-tab\-in\-background
425 Open the current link in a new tab in the background.
428 open\-link\-in\-new\-window
430 Open the current link in a new window.
438 open\-new\-tab\-in\-background
440 Open a new tab in the background.
455 Open options manager.
460 Open a quit confirmation dialog box.
465 Quit without confirmation.
475 Reload the current page.
480 Re\-render the current page.
485 Reset form items to their initial values.
490 Show information about the currently used resources.
495 Save the current document in source form.
500 Save the current document in formatted form.
535 Search for a text pattern.
540 Search backwards for a text pattern.
545 Search link text by typing ahead.
548 search\-typeahead\-link
550 Search link text by typing ahead.
553 search\-typeahead\-text
555 Search document text by typing ahead.
558 search\-typeahead\-text\-back
560 Search document text backwards by typing ahead.
565 Show terminal options dialog.
575 Submit form and reload.
583 tab\-close\-all\-but\-current
585 Close all tabs but the current one.
588 tab\-external\-command
590 Pass URI of current tab to external command.
600 Move the current tab to the left.
605 Move the current tab to the right.
620 Open the terminal resize dialog.
625 Toggle rendering of page using CSS.
628 toggle\-display\-images
630 Toggle displaying of links to images.
633 toggle\-display\-tables
635 Toggle rendering of tables.
638 toggle\-document\-colors
640 Toggle usage of document specific colors.
645 Toggle rendering page as HTML / plain text.
650 Toggle mouse handling.
653 toggle\-numbered\-links
655 Toggle displaying of links numbers.
658 toggle\-plain\-compress\-empty\-lines
660 Toggle plain renderer compression of empty lines.
665 Toggle wrapping of text.
670 View the current image.
676 Attempt to auto\-complete the input.
681 Attempt to auto\-complete a local file.
684 auto\-complete\-unambiguous
686 Attempt to unambiguously auto\-complete the input.
691 Delete character in front of the cursor.
694 beginning\-of\-buffer
696 Go to the first line of the buffer.
701 Cancel current state.
706 Copy text to clipboard.
711 Cut text to clipboard.
716 Delete character under cursor.
721 Move cursor downwards.
726 Go to the end of the page/line.
731 Go to the last line of the buffer.
736 Follow the current link.
741 Go to the start of the page/line.
746 Delete to beginning of line.
751 Delete to end of line.
756 Delete backwards to start of word.
761 Move the cursor left.
766 Move cursor before current word.
771 Move cursor after current word.
776 Move to the next item.
781 Open in external editor.
786 Paste text from the clipboard.
791 Move to the previous item.
801 Move the cursor right.
804 search\-toggle\-regex
806 Toggle regex matching (type\-ahead searching).
817 Cancel current state.
822 Delete character under cursor.
827 Move cursor downwards.
832 Go to the end of the page/line.
837 Follow the current link.
847 Go to the start of the page/line.
852 Move the cursor left.
862 Move to the next item.
867 Move downwards by a page.
872 Move upwards by a page.
877 Move to the previous item.
887 Move the cursor right.
892 Search for a text pattern.
897 Select current highlighted item.
909 .SH "DEFAULT BINDINGS"
910 The default bindings are shown below. Any bindings in ~/.elinks/elinks.conf will override these.
916 Move downwards by a page (\fImove\-page\-down\fR)
921 Search link text by typing ahead (\fIsearch\-typeahead\fR)
926 Toggle usage of document specific colors (\fItoggle\-document\-colors\fR)
931 Toggle displaying of links to images (\fItoggle\-display\-images\fR)
936 Open a Lua console (\fIlua\-console\fR)
941 Toggle displaying of links numbers (\fItoggle\-numbered\-links\fR)
946 Search for a text pattern (\fIsearch\fR)
951 Enter ex\-mode (command line) (\fIexmode\fR)
956 Previous tab (\fItab\-prev\fR)
961 Move the current tab to the left (\fItab\-move\-left\fR)
966 Show information about the current page (\fIdocument\-info\fR)
971 Next tab (\fItab\-next\fR)
976 Move the current tab to the right (\fItab\-move\-right\fR)
981 Search backwards for a text pattern (\fIsearch\-back\fR)
986 Add a new bookmark using current link (\fIadd\-bookmark\-link\fR)
991 Move to the start of the document (\fImove\-document\-start\fR)
996 Move upwards by a page (\fImove\-page\-up\fR)
1001 Open cache manager (\fIcache\-manager\fR)
1006 Open download manager (\fIdownload\-manager\fR)
1011 Open "Go to URL" dialog box containing the current link URL (\fIgoto\-url\-current\-link\fR)
1016 Move to the end of the document (\fImove\-document\-end\fR)
1021 Open form history manager (\fIformhist\-manager\fR)
1026 Move downwards by a page (\fImove\-page\-down\fR)
1031 Open "Go to URL" dialog box containing the current URL (\fIgoto\-url\-current\fR)
1036 Go to the homepage (\fIgoto\-url\-home\fR)
1041 Open cookie manager (\fIcookie\-manager\fR)
1046 Reload cookies file (\fIcookies\-load\fR)
1051 Open the link context menu (\fIlink\-menu\fR)
1056 Redraw the terminal (\fIredraw\fR)
1061 Find the previous occurrence of the current search text (\fIfind\-next\-back\fR)
1066 Scroll down (\fIscroll\-down\fR)
1071 Scroll up (\fIscroll\-up\fR)
1076 Quit without confirmation (\fIreally\-quit\fR)
1081 Reload the current page (\fIreload\fR)
1086 Open the current link in a new tab in the background (\fIopen\-link\-in\-new\-tab\-in\-background\fR)
1091 Toggle wrapping of text (\fItoggle\-wrap\-text\fR)
1096 Scroll left (\fIscroll\-left\fR)
1101 Go at a specified mark (\fImark\-goto\fR)
1106 Toggle rendering page as HTML / plain text (\fItoggle\-html\-plain\fR)
1111 Scroll right (\fIscroll\-right\fR)
1116 Add a new bookmark (\fIadd\-bookmark\fR)
1121 Move upwards by a page (\fImove\-page\-up\fR)
1126 Close tab (\fItab\-close\fR)
1131 Download the current link (\fIlink\-download\fR)
1136 Open the tab menu (\fItab\-menu\fR)
1141 Maximize the current frame (\fIframe\-maximize\fR)
1146 Open "Go to URL" dialog box (\fIgoto\-url\fR)
1151 Open history manager (\fIhistory\-manager\fR)
1156 Open keybinding manager (\fIkeybinding\-manager\fR)
1161 Jump to link (\fIjump\-to\-link\fR)
1166 Set a mark (\fImark\-set\fR)
1171 Find the next occurrence of the current search text (\fIfind\-next\fR)
1176 Open options manager (\fIoptions\-manager\fR)
1181 Open a quit confirmation dialog box (\fIquit\fR)
1186 Attempt to resume download of the current link (\fIlink\-download\-resume\fR)
1191 Open bookmark manager (\fIbookmark\-manager\fR)
1196 Open a new tab (\fIopen\-new\-tab\fR)
1201 Go forward in history (\fIhistory\-move\-forward\fR)
1206 View the current image (\fIview\-image\fR)
1211 Follow the current link, forcing reload of the target (\fIlink\-follow\-reload\fR)
1216 Abort connection (\fIabort\-connection\fR)
1221 Scroll left (\fIscroll\-left\fR)
1226 Show information about the current page protocol headers (\fIheader\-info\fR)
1231 Scroll right (\fIscroll\-right\fR)
1236 Backspace the last entered digit of the current prefix (\fIbackspace\-prefix\fR)
1241 Scroll down (\fIscroll\-down\fR)
1246 Move to the next link (\fImove\-link\-next\fR)
1251 Move to the end of the document (\fImove\-document\-end\fR)
1256 Follow the current link (\fIlink\-follow\fR)
1261 Follow the current link, forcing reload of the target (\fIlink\-follow\-reload\fR)
1266 Activate the menu (\fImenu\fR)
1271 Open the File menu (\fIfile\-menu\fR)
1276 Activate the menu (\fImenu\fR)
1281 Move to the start of the document (\fImove\-document\-start\fR)
1286 Scroll up (\fIscroll\-up\fR)
1291 Copy text to clipboard (\fIcopy\-clipboard\fR)
1296 Return to the previous document in history (\fIhistory\-move\-back\fR)
1301 Move downwards by a page (\fImove\-page\-down\fR)
1306 Move upwards by a page (\fImove\-page\-up\fR)
1311 Follow the current link (\fIlink\-follow\fR)
1316 Follow the current link, forcing reload of the target (\fIlink\-follow\-reload\fR)
1321 Move to the next frame (\fIframe\-next\fR)
1326 Move to the previous frame (\fIframe\-prev\fR)
1331 Move to the previous frame (\fIframe\-prev\fR)
1336 Move to the previous link (\fImove\-link\-prev\fR)
1342 Go to the first line of the buffer (\fIbeginning\-of\-buffer\fR)
1347 Go to the last line of the buffer (\fIend\-of\-buffer\fR)
1352 Go to the start of the page/line (\fIhome\fR)
1357 Move cursor before current word (\fImove\-backward\-word\fR)
1362 Delete character under cursor (\fIdelete\fR)
1367 Go to the end of the page/line (\fIend\fR)
1372 Move cursor after current word (\fImove\-forward\-word\fR)
1377 Delete character in front of the cursor (\fIbackspace\fR)
1382 Delete to end of line (\fIkill\-to\-eol\fR)
1387 Redraw the terminal (\fIredraw\fR)
1392 Toggle regex matching (type\-ahead searching) (\fIsearch\-toggle\-regex\fR)
1397 Attempt to auto\-complete a local file (\fIauto\-complete\-file\fR)
1402 Attempt to unambiguously auto\-complete the input (\fIauto\-complete\-unambiguous\fR)
1407 Open in external editor (\fIopen\-external\fR)
1412 Delete to beginning of line (\fIkill\-to\-bol\fR)
1417 Paste text from the clipboard (\fIpaste\-clipboard\fR)
1422 Attempt to auto\-complete the input (\fIauto\-complete\fR)
1427 Cut text to clipboard (\fIcut\-clipboard\fR)
1430 \fIAlt\-Backspace\fR
1432 Delete backwards to start of word (\fIkill\-word\-back\fR)
1437 Delete character in front of the cursor (\fIbackspace\fR)
1442 Delete character under cursor (\fIdelete\fR)
1447 Move cursor downwards (\fIdown\fR)
1452 Go to the end of the page/line (\fIend\fR)
1457 Follow the current link (\fIenter\fR)
1462 Cancel current state (\fIcancel\fR)
1467 Open in external editor (\fIopen\-external\fR)
1472 Go to the start of the page/line (\fIhome\fR)
1477 Copy text to clipboard (\fIcopy\-clipboard\fR)
1482 Move the cursor left (\fIleft\fR)
1487 Move the cursor right (\fIright\fR)
1492 Move to the next item (\fInext\-item\fR)
1497 Move to the previous item (\fIprevious\-item\fR)
1502 Move to the previous item (\fIprevious\-item\fR)
1507 Move cursor upwards (\fIup\fR)
1513 Select current highlighted item (\fIselect\fR)
1518 Mark item (\fImark\-item\fR)
1523 Expand item (\fIexpand\fR)
1528 Collapse item (\fIunexpand\fR)
1533 Search for a text pattern (\fIsearch\fR)
1538 Expand item (\fIexpand\fR)
1543 Go to the start of the page/line (\fIhome\fR)
1548 Move upwards by a page (\fIpage\-up\fR)
1553 Go to the end of the page/line (\fIend\fR)
1558 Move downwards by a page (\fIpage\-down\fR)
1563 Redraw the terminal (\fIredraw\fR)
1568 Move cursor downwards (\fIdown\fR)
1573 Move cursor upwards (\fIup\fR)
1578 Move upwards by a page (\fIpage\-up\fR)
1583 Move downwards by a page (\fIpage\-down\fR)
1588 Expand item (\fIexpand\fR)
1593 Collapse item (\fIunexpand\fR)
1598 Collapse item (\fIunexpand\fR)
1603 Delete character under cursor (\fIdelete\fR)
1608 Move cursor downwards (\fIdown\fR)
1613 Go to the end of the page/line (\fIend\fR)
1618 Follow the current link (\fIenter\fR)
1623 Cancel current state (\fIcancel\fR)
1628 Go to the start of the page/line (\fIhome\fR)
1633 Mark item (\fImark\-item\fR)
1638 Move the cursor left (\fIleft\fR)
1643 Move downwards by a page (\fIpage\-down\fR)
1648 Move upwards by a page (\fIpage\-up\fR)
1653 Move the cursor right (\fIright\fR)
1658 Move to the next item (\fInext\-item\fR)
1663 Move to the previous item (\fIprevious\-item\fR)
1668 Move to the previous item (\fIprevious\-item\fR)
1673 Move cursor upwards (\fIup\fR)
1676 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 asciidoc format and cleaned up by Jonas Fonseca.
1679 \fBelinks\fR(1), \fBelinks.conf\fR(5)