3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: ELinks keybindings
7 .\" Source: ELinks 0.12pre6
10 .TH "ELINKSKEYS" "5" "10/26/2012" "ELinks 0\&.12pre6" "ELinks keybindings"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 elinkskeys \- keybindings for ELinks
34 Information on how to configure keybinding and overview of the default keybindings\&.
37 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\&.
39 Key binding statements are of the form:
45 bind <keymap> <keystroke> = <action>
58 \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\&.
63 is a case sensitive key, which you can prefix with
65 \fIAlt\-\fR, or both\&.
67 must be followed by an uppercase key\&. See below for a list of valid keys\&.
72 is what the key should do\&. The actions available are dependent on the keymap, and are listed separately below\&.
75 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\&.
77 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\&.
78 .SH "EXAMPLE BINDINGS"
80 Some sample keybindings:
86 bind "main" "v" = "view\-image"
87 bind "main" "l" = "jump\-to\-link"
88 bind "main" "L" = "link\-menu"
89 bind "main" "F10" = "file\-menu"
90 bind "main" "F9" = "menu"
91 bind "main" "Escape" = "menu"
92 bind "edit" "Ctrl\-R" = "auto\-complete\-unambiguous"
93 bind "edit" "Ctrl\-W" = "auto\-complete"
94 bind "edit" "Ctrl\-K" = "kill\-to\-eol"
95 bind "menu" "Ctrl\-B" = "page\-up"
96 bind "menu" "PageUp" = "page\-up"
97 bind "menu" "Ctrl\-F" = "page\-down"
98 bind "menu" "PageDown" = "page\-down"
99 # ELinks with Lua support
100 bind "main" "," = "lua\-console"
107 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\&.
109 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)\&.
120 Add a new bookmark\&.
125 Add a new bookmark using current link\&.
130 Bookmark all open tabs\&.
135 Open authentication manager\&.
140 Backspace the last entered digit of the current prefix\&.
145 Open bookmark manager\&.
150 Open cache manager\&.
155 Free unused cache entries\&.
160 Open cookie manager\&.
165 Reload cookies file\&.
170 Copy text to clipboard\&.
175 Show information about the current page\&.
180 Open download manager\&.
185 Enter ex\-mode (command line)\&.
190 Open the File menu\&.
195 Find the next occurrence of the current search text\&.
200 Find the previous occurrence of the current search text\&.
205 Forget authentication credentials\&.
210 Open form history manager\&.
213 frame\-external\-command
215 Pass URI of current frame to external command\&.
220 Maximize the current frame\&.
225 Move to the next frame\&.
230 Move to the previous frame\&.
235 Open "Go to URL" dialog box\&.
240 Open "Go to URL" dialog box containing the current URL\&.
243 goto\-url\-current\-link
245 Open "Go to URL" dialog box containing the current link URL\&.
250 Go to the homepage\&.
255 Show information about the current page protocol headers\&.
260 Open history manager\&.
265 Return to the previous document in history\&.
268 history\-move\-forward
270 Go forward in history\&.
280 Open keybinding manager\&.
283 kill\-backgrounded\-connections
285 Kill all backgrounded connections\&.
290 Download the current link\&.
293 link\-download\-image
295 Download the current image\&.
298 link\-download\-resume
300 Attempt to resume download of the current link\&.
303 link\-external\-command
305 Pass URI of current link to external command\&.
310 Follow the current link\&.
315 Follow the current link, forcing reload of the target\&.
320 Open the link context menu\&.
325 Open the form fields menu\&.
330 Open a Lua console\&.
335 Go at a specified mark\&.
358 move\-cursor\-line\-start
360 Move cursor to the start of the line\&.
375 Move to the end of the document\&.
378 move\-document\-start
380 Move to the start of the document\&.
385 Move one link down\&.
388 move\-link\-down\-line
390 Move to the next line with a link\&.
395 Move one link left\&.
398 move\-link\-left\-line
400 Move one link left or to the previous link\&.
405 Move to the next link\&.
410 Move to the previous link\&.
415 Move one link right\&.
418 move\-link\-right\-line
420 Move one link right or to the next link\&.
430 Move to the previous line with a link\&.
435 Move downwards by a page\&.
440 Move upwards by a page\&.
443 open\-link\-in\-new\-tab
445 Open the current link in a new tab\&.
448 open\-link\-in\-new\-tab\-in\-background
450 Open the current link in a new tab in the background\&.
453 open\-link\-in\-new\-window
455 Open the current link in a new window\&.
463 open\-new\-tab\-in\-background
465 Open a new tab in the background\&.
480 Open options manager\&.
485 Open a quit confirmation dialog box\&.
490 Quit without confirmation\&.
495 Redraw the terminal\&.
500 Reload the current page\&.
505 Re\-render the current page\&.
510 Reset form items to their initial values\&.
515 Show information about the currently used resources\&.
520 Save the current document in source form\&.
525 Save the current document in formatted form\&.
560 Search for a text pattern\&.
565 Search backwards for a text pattern\&.
570 Search link text by typing ahead\&.
573 search\-typeahead\-link
575 Search link text by typing ahead\&.
578 search\-typeahead\-text
580 Search document text by typing ahead\&.
583 search\-typeahead\-text\-back
585 Search document text backwards by typing ahead\&.
590 Show terminal options dialog\&.
600 Submit form and reload\&.
608 tab\-close\-all\-but\-current
610 Close all tabs but the current one\&.
613 tab\-external\-command
615 Pass URI of current tab to external command\&.
625 Move the current tab to the left\&.
630 Move the current tab to the right\&.
645 Open the terminal resize dialog\&.
650 Toggle rendering of page using CSS\&.
653 toggle\-display\-images
655 Toggle displaying of links to images\&.
658 toggle\-display\-tables
660 Toggle rendering of tables\&.
663 toggle\-document\-colors
665 Toggle usage of document specific colors\&.
670 Toggle rendering page as HTML / plain text\&.
675 Toggle mouse handling\&.
678 toggle\-numbered\-links
680 Toggle displaying of links numbers\&.
683 toggle\-plain\-compress\-empty\-lines
685 Toggle plain renderer compression of empty lines\&.
690 Toggle wrapping of text\&.
695 View the current image\&.
701 Attempt to auto\-complete the input\&.
706 Attempt to auto\-complete a local file\&.
709 auto\-complete\-unambiguous
711 Attempt to unambiguously auto\-complete the input\&.
716 Delete character in front of the cursor\&.
719 beginning\-of\-buffer
721 Go to the first line of the buffer\&.
726 Cancel current state\&.
731 Copy text to clipboard\&.
736 Cut text to clipboard\&.
741 Delete character under cursor\&.
746 Move cursor downwards\&.
751 Go to the end of the page/line\&.
756 Go to the last line of the buffer\&.
761 Follow the current link\&.
766 Go to the start of the page/line\&.
771 Delete to beginning of line\&.
776 Delete to end of line\&.
781 Delete backwards to start of word\&.
786 Move the cursor left\&.
791 Move cursor before current word\&.
796 Move cursor after current word\&.
801 Move to the next item\&.
806 Open in external editor\&.
811 Paste text from the clipboard\&.
816 Move to the previous item\&.
821 Redraw the terminal\&.
826 Move the cursor right\&.
829 search\-toggle\-regex
831 Toggle regex matching (type\-ahead searching)\&.
836 Move cursor upwards\&.
842 Cancel current state\&.
847 Delete character under cursor\&.
852 Move cursor downwards\&.
857 Go to the end of the page/line\&.
862 Follow the current link\&.
872 Go to the start of the page/line\&.
877 Move the cursor left\&.
887 Move to the next item\&.
892 Move downwards by a page\&.
897 Move upwards by a page\&.
902 Move to the previous item\&.
907 Redraw the terminal\&.
912 Move the cursor right\&.
917 Search for a text pattern\&.
922 Select current highlighted item\&.
932 Move cursor upwards\&.
934 .SH "DEFAULT BINDINGS"
936 The default bindings are shown below\&. Any bindings in ~/\&.elinks/elinks\&.conf will override these\&.
941 Move downwards by a page (\fImove\-page\-down\fR)
946 Search link text by typing ahead (\fIsearch\-typeahead\fR)
951 Toggle usage of document specific colors (\fItoggle\-document\-colors\fR)
956 Toggle displaying of links to images (\fItoggle\-display\-images\fR)
961 Open a Lua console (\fIlua\-console\fR)
966 Toggle displaying of links numbers (\fItoggle\-numbered\-links\fR)
971 Search for a text pattern (\fIsearch\fR)
976 Enter ex\-mode (command line) (\fIexmode\fR)
981 Previous tab (\fItab\-prev\fR)
986 Move the current tab to the left (\fItab\-move\-left\fR)
991 Show information about the current page (\fIdocument\-info\fR)
996 Next tab (\fItab\-next\fR)
1001 Move the current tab to the right (\fItab\-move\-right\fR)
1006 Search backwards for a text pattern (\fIsearch\-back\fR)
1011 Add a new bookmark using current link (\fIadd\-bookmark\-link\fR)
1016 Move to the start of the document (\fImove\-document\-start\fR)
1021 Move upwards by a page (\fImove\-page\-up\fR)
1026 Open cache manager (\fIcache\-manager\fR)
1031 Open download manager (\fIdownload\-manager\fR)
1036 Open "Go to URL" dialog box containing the current link URL (\fIgoto\-url\-current\-link\fR)
1041 Move to the end of the document (\fImove\-document\-end\fR)
1046 Open form history manager (\fIformhist\-manager\fR)
1051 Move downwards by a page (\fImove\-page\-down\fR)
1056 Open "Go to URL" dialog box containing the current URL (\fIgoto\-url\-current\fR)
1061 Go to the homepage (\fIgoto\-url\-home\fR)
1066 Open cookie manager (\fIcookie\-manager\fR)
1071 Reload cookies file (\fIcookies\-load\fR)
1076 Open the link context menu (\fIlink\-menu\fR)
1081 Redraw the terminal (\fIredraw\fR)
1086 Find the previous occurrence of the current search text (\fIfind\-next\-back\fR)
1091 Scroll down (\fIscroll\-down\fR)
1096 Scroll up (\fIscroll\-up\fR)
1101 Quit without confirmation (\fIreally\-quit\fR)
1106 Reload the current page (\fIreload\fR)
1111 Open the current link in a new tab in the background (\fIopen\-link\-in\-new\-tab\-in\-background\fR)
1116 Toggle wrapping of text (\fItoggle\-wrap\-text\fR)
1121 Scroll left (\fIscroll\-left\fR)
1126 Go at a specified mark (\fImark\-goto\fR)
1131 Toggle rendering page as HTML / plain text (\fItoggle\-html\-plain\fR)
1136 Scroll right (\fIscroll\-right\fR)
1141 Add a new bookmark (\fIadd\-bookmark\fR)
1146 Move upwards by a page (\fImove\-page\-up\fR)
1151 Close tab (\fItab\-close\fR)
1156 Download the current link (\fIlink\-download\fR)
1161 Open the tab menu (\fItab\-menu\fR)
1166 Maximize the current frame (\fIframe\-maximize\fR)
1171 Open "Go to URL" dialog box (\fIgoto\-url\fR)
1176 Open history manager (\fIhistory\-manager\fR)
1181 Open keybinding manager (\fIkeybinding\-manager\fR)
1186 Jump to link (\fIjump\-to\-link\fR)
1191 Set a mark (\fImark\-set\fR)
1196 Find the next occurrence of the current search text (\fIfind\-next\fR)
1201 Open options manager (\fIoptions\-manager\fR)
1206 Open a quit confirmation dialog box (\fIquit\fR)
1211 Attempt to resume download of the current link (\fIlink\-download\-resume\fR)
1216 Open bookmark manager (\fIbookmark\-manager\fR)
1221 Open a new tab (\fIopen\-new\-tab\fR)
1226 Go forward in history (\fIhistory\-move\-forward\fR)
1231 View the current image (\fIview\-image\fR)
1236 Follow the current link, forcing reload of the target (\fIlink\-follow\-reload\fR)
1241 Abort connection (\fIabort\-connection\fR)
1246 Scroll left (\fIscroll\-left\fR)
1251 Show information about the current page protocol headers (\fIheader\-info\fR)
1256 Scroll right (\fIscroll\-right\fR)
1261 Backspace the last entered digit of the current prefix (\fIbackspace\-prefix\fR)
1266 Scroll down (\fIscroll\-down\fR)
1271 Move to the next link (\fImove\-link\-next\fR)
1276 Move to the end of the document (\fImove\-document\-end\fR)
1281 Follow the current link (\fIlink\-follow\fR)
1286 Follow the current link, forcing reload of the target (\fIlink\-follow\-reload\fR)
1291 Activate the menu (\fImenu\fR)
1296 Open the File menu (\fIfile\-menu\fR)
1301 Activate the menu (\fImenu\fR)
1306 Move to the start of the document (\fImove\-document\-start\fR)
1311 Scroll up (\fIscroll\-up\fR)
1316 Copy text to clipboard (\fIcopy\-clipboard\fR)
1321 Return to the previous document in history (\fIhistory\-move\-back\fR)
1326 Move downwards by a page (\fImove\-page\-down\fR)
1331 Move upwards by a page (\fImove\-page\-up\fR)
1336 Follow the current link (\fIlink\-follow\fR)
1341 Follow the current link, forcing reload of the target (\fIlink\-follow\-reload\fR)
1346 Move to the next frame (\fIframe\-next\fR)
1351 Move to the previous frame (\fIframe\-prev\fR)
1356 Move to the previous frame (\fIframe\-prev\fR)
1361 Move to the previous link (\fImove\-link\-prev\fR)
1367 Go to the first line of the buffer (\fIbeginning\-of\-buffer\fR)
1372 Go to the last line of the buffer (\fIend\-of\-buffer\fR)
1377 Go to the start of the page/line (\fIhome\fR)
1382 Move cursor before current word (\fImove\-backward\-word\fR)
1387 Delete character under cursor (\fIdelete\fR)
1392 Go to the end of the page/line (\fIend\fR)
1397 Move cursor after current word (\fImove\-forward\-word\fR)
1402 Delete character in front of the cursor (\fIbackspace\fR)
1407 Delete to end of line (\fIkill\-to\-eol\fR)
1412 Redraw the terminal (\fIredraw\fR)
1417 Toggle regex matching (type\-ahead searching) (\fIsearch\-toggle\-regex\fR)
1422 Attempt to auto\-complete a local file (\fIauto\-complete\-file\fR)
1427 Attempt to unambiguously auto\-complete the input (\fIauto\-complete\-unambiguous\fR)
1432 Open in external editor (\fIopen\-external\fR)
1437 Delete to beginning of line (\fIkill\-to\-bol\fR)
1442 Paste text from the clipboard (\fIpaste\-clipboard\fR)
1447 Attempt to auto\-complete the input (\fIauto\-complete\fR)
1452 Cut text to clipboard (\fIcut\-clipboard\fR)
1455 \fIAlt\-Backspace\fR
1457 Delete backwards to start of word (\fIkill\-word\-back\fR)
1462 Delete character in front of the cursor (\fIbackspace\fR)
1467 Delete character under cursor (\fIdelete\fR)
1472 Move cursor downwards (\fIdown\fR)
1477 Go to the end of the page/line (\fIend\fR)
1482 Follow the current link (\fIenter\fR)
1487 Cancel current state (\fIcancel\fR)
1492 Open in external editor (\fIopen\-external\fR)
1497 Go to the start of the page/line (\fIhome\fR)
1502 Copy text to clipboard (\fIcopy\-clipboard\fR)
1507 Move the cursor left (\fIleft\fR)
1512 Move the cursor right (\fIright\fR)
1517 Move to the next item (\fInext\-item\fR)
1522 Move to the previous item (\fIprevious\-item\fR)
1527 Move to the previous item (\fIprevious\-item\fR)
1532 Move cursor upwards (\fIup\fR)
1538 Select current highlighted item (\fIselect\fR)
1543 Mark item (\fImark\-item\fR)
1548 Expand item (\fIexpand\fR)
1553 Collapse item (\fIunexpand\fR)
1558 Search for a text pattern (\fIsearch\fR)
1563 Expand item (\fIexpand\fR)
1568 Go to the start of the page/line (\fIhome\fR)
1573 Move upwards by a page (\fIpage\-up\fR)
1578 Go to the end of the page/line (\fIend\fR)
1583 Move downwards by a page (\fIpage\-down\fR)
1588 Redraw the terminal (\fIredraw\fR)
1593 Move cursor downwards (\fIdown\fR)
1598 Move cursor upwards (\fIup\fR)
1603 Move upwards by a page (\fIpage\-up\fR)
1608 Move downwards by a page (\fIpage\-down\fR)
1613 Expand item (\fIexpand\fR)
1618 Collapse item (\fIunexpand\fR)
1623 Collapse item (\fIunexpand\fR)
1628 Delete character under cursor (\fIdelete\fR)
1633 Move cursor downwards (\fIdown\fR)
1638 Go to the end of the page/line (\fIend\fR)
1643 Follow the current link (\fIenter\fR)
1648 Cancel current state (\fIcancel\fR)
1653 Go to the start of the page/line (\fIhome\fR)
1658 Mark item (\fImark\-item\fR)
1663 Move the cursor left (\fIleft\fR)
1668 Move downwards by a page (\fIpage\-down\fR)
1673 Move upwards by a page (\fIpage\-up\fR)
1678 Move the cursor right (\fIright\fR)
1683 Move to the next item (\fInext\-item\fR)
1688 Move to the previous item (\fIprevious\-item\fR)
1693 Move to the previous item (\fIprevious\-item\fR)
1698 Move cursor upwards (\fIup\fR)
1702 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\&.
1705 \fBelinks\fR(1), \fBelinks.conf\fR(5)