1ELINKSKEYS(5)                 ELinks keybindings                 ELINKSKEYS(5)
2
3
4

NAME

6       elinkskeys - keybindings for ELinks
7

SYNOPSIS

9       Information on how to configure keybinding and overview of the default
10       keybindings.
11

DESCRIPTION

13       Key binding for elinks should be placed in the file
14       ~/.elinks/elinks.conf. Note that any information regarding their
15       format/structure may not be up-to-date. If you will discover that,
16       please feed us with a patch.
17
18       Key binding statements are of the form:
19
20           bind <keymap> <keystroke> = <action>
21
22       where:
23
24       <keymap>
25           is main, edit, or menu. The main keymap is used for general
26           browsing. The edit keymap is used for editing text fields. The menu
27           keymap is used for navigating menus.
28
29       <keystroke>
30           is a case sensitive key, which you can prefix with Ctrl-, Alt-, or
31           both.  Ctrl- must be followed by an uppercase key. See below for a
32           list of valid keys.
33
34       <action>
35           is what the key should do. The actions available are dependent on
36           the keymap, and are listed separately below.
37
38       All words/strings may all be quoted "like so". Backslashes are escape
39       characters, even if not between quotes. Lines beginning with a hash
40       character (#) are comments.
41
42       Keys can be unbound just by binding them to the special none action. It
43       may be of use if you accidentally type a key often.
44

EXAMPLE BINDINGS

46       Some sample keybindings:
47
48           bind "main" "v" = "view-image"
49           bind "main" "l" = "jump-to-link"
50           bind "main" "L" = "link-menu"
51           bind "main" "F10" = "file-menu"
52           bind "main" "F9" = "menu"
53           bind "main" "Escape" = "menu"
54           bind "edit" "Ctrl-R" = "auto-complete-unambiguous"
55           bind "edit" "Ctrl-W" = "auto-complete"
56           bind "edit" "Ctrl-K" = "kill-to-eol"
57           bind "menu" "Ctrl-B" = "page-up"
58           bind "menu" "PageUp" = "page-up"
59           bind "menu" "Ctrl-F" = "page-down"
60           bind "menu" "PageDown" = "page-down"
61           # ELinks with Lua support
62           bind "main" "," = "lua-console"
63

KEYS

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

KEYMAP ACTIONS

74   MAIN ACTIONS
75       abort-connection
76           Abort connection.
77
78       add-bookmark
79           Add a new bookmark.
80
81       add-bookmark-link
82           Add a new bookmark using current link.
83
84       add-bookmark-tabs
85           Bookmark all open tabs.
86
87       auth-manager
88           Open authentication manager.
89
90       backspace-prefix
91           Backspace the last entered digit of the current prefix.
92
93       bookmark-manager
94           Open bookmark manager.
95
96       cache-manager
97           Open cache manager.
98
99       cache-minimize
100           Free unused cache entries.
101
102       cookie-manager
103           Open cookie manager.
104
105       cookies-load
106           Reload cookies file.
107
108       copy-clipboard
109           Copy text to clipboard.
110
111       document-info
112           Show information about the current page.
113
114       download-manager
115           Open download manager.
116
117       exmode
118           Enter ex-mode (command line).
119
120       file-menu
121           Open the File menu.
122
123       find-next
124           Find the next occurrence of the current search text.
125
126       find-next-back
127           Find the previous occurrence of the current search text.
128
129       forget-credentials
130           Forget authentication credentials.
131
132       formhist-manager
133           Open form history manager.
134
135       frame-external-command
136           Pass URI of current frame to external command.
137
138       frame-maximize
139           Maximize the current frame.
140
141       frame-next
142           Move to the next frame.
143
144       frame-prev
145           Move to the previous frame.
146
147       goto-url
148           Open "Go to URL" dialog box.
149
150       goto-url-current
151           Open "Go to URL" dialog box containing the current URL.
152
153       goto-url-current-link
154           Open "Go to URL" dialog box containing the current link URL.
155
156       goto-url-home
157           Go to the homepage.
158
159       header-info
160           Show information about the current page protocol headers.
161
162       history-manager
163           Open history manager.
164
165       history-move-back
166           Return to the previous document in history.
167
168       history-move-forward
169           Go forward in history.
170
171       jump-to-link
172           Jump to link.
173
174       keybinding-manager
175           Open keybinding manager.
176
177       kill-backgrounded-connections
178           Kill all backgrounded connections.
179
180       link-download
181           Download the current link.
182
183       link-download-image
184           Download the current image.
185
186       link-download-resume
187           Attempt to resume download of the current link.
188
189       link-external-command
190           Pass URI of current link to external command.
191
192       link-follow
193           Follow the current link.
194
195       link-follow-reload
196           Follow the current link, forcing reload of the target.
197
198       link-menu
199           Open the link context menu.
200
201       link-form-menu
202           Open the form fields menu.
203
204       lua-console
205           Open a Lua console.
206
207       mark-goto
208           Go at a specified mark.
209
210       mark-set
211           Set a mark.
212
213       menu
214           Activate the menu.
215
216       move-cursor-down
217           Move cursor down.
218
219       move-cursor-left
220           Move cursor left.
221
222       move-cursor-line-start
223           Move cursor to the start of the line.
224
225       move-cursor-right
226           Move cursor right.
227
228       move-cursor-up
229           Move cursor up.
230
231       move-document-end
232           Move to the end of the document.
233
234       move-document-start
235           Move to the start of the document.
236
237       move-link-down
238           Move one link down.
239
240       move-link-down-line
241           Move to the next line with a link.
242
243       move-link-left
244           Move one link left.
245
246       move-link-left-line
247           Move one link left or to the previous link.
248
249       move-link-next
250           Move to the next link.
251
252       move-link-prev
253           Move to the previous link.
254
255       move-link-right
256           Move one link right.
257
258       move-link-right-line
259           Move one link right or to the next link.
260
261       move-link-up
262           Move one link up.
263
264       move-link-up-line
265           Move to the previous line with a link.
266
267       move-page-down
268           Move downwards by a page.
269
270       move-page-up
271           Move upwards by a page.
272
273       open-link-in-new-tab
274           Open the current link in a new tab.
275
276       open-link-in-new-tab-in-background
277           Open the current link in a new tab in the background.
278
279       open-link-in-new-window
280           Open the current link in a new window.
281
282       open-new-tab
283           Open a new tab.
284
285       open-new-tab-in-background
286           Open a new tab in the background.
287
288       open-new-window
289           Open a new window.
290
291       open-os-shell
292           Open an OS shell.
293
294       options-manager
295           Open options manager.
296
297       quit
298           Open a quit confirmation dialog box.
299
300       really-quit
301           Quit without confirmation.
302
303       redraw
304           Redraw the terminal.
305
306       reload
307           Reload the current page.
308
309       rerender
310           Re-render the current page.
311
312       reset-form
313           Reset form items to their initial values.
314
315       resource-info
316           Show information about the currently used resources.
317
318       save-as
319           Save the current document in source form.
320
321       save-formatted
322           Save the current document in formatted form.
323
324       save-options
325           Save options.
326
327       save-url-as
328           Save URL as.
329
330       scroll-down
331           Scroll down.
332
333       scroll-left
334           Scroll left.
335
336       scroll-right
337           Scroll right.
338
339       scroll-up
340           Scroll up.
341
342       search
343           Search for a text pattern.
344
345       search-back
346           Search backwards for a text pattern.
347
348       search-typeahead
349           Search link text by typing ahead.
350
351       search-typeahead-link
352           Search link text by typing ahead.
353
354       search-typeahead-text
355           Search document text by typing ahead.
356
357       search-typeahead-text-back
358           Search document text backwards by typing ahead.
359
360       show-term-options
361           Show terminal options dialog.
362
363       submit-form
364           Submit form.
365
366       submit-form-reload
367           Submit form and reload.
368
369       tab-close
370           Close tab.
371
372       tab-close-all-but-current
373           Close all tabs but the current one.
374
375       tab-external-command
376           Pass URI of current tab to external command.
377
378       tab-menu
379           Open the tab menu.
380
381       tab-move-left
382           Move the current tab to the left.
383
384       tab-move-right
385           Move the current tab to the right.
386
387       tab-next
388           Next tab.
389
390       tab-prev
391           Previous tab.
392
393       terminal-resize
394           Open the terminal resize dialog.
395
396       toggle-css
397           Toggle rendering of page using CSS.
398
399       toggle-display-images
400           Toggle displaying of links to images.
401
402       toggle-display-tables
403           Toggle rendering of tables.
404
405       toggle-document-colors
406           Toggle usage of document specific colors.
407
408       toggle-html-plain
409           Toggle rendering page as HTML / plain text.
410
411       toggle-mouse
412           Toggle mouse handling.
413
414       toggle-numbered-links
415           Toggle displaying of links numbers.
416
417       toggle-plain-compress-empty-lines
418           Toggle plain renderer compression of empty lines.
419
420       toggle-wrap-text
421           Toggle wrapping of text.
422
423       view-image
424           View the current image.
425
426   EDIT ACTIONS
427       auto-complete
428           Attempt to auto-complete the input.
429
430       auto-complete-file
431           Attempt to auto-complete a local file.
432
433       auto-complete-unambiguous
434           Attempt to unambiguously auto-complete the input.
435
436       backspace
437           Delete character in front of the cursor.
438
439       beginning-of-buffer
440           Go to the first line of the buffer.
441
442       cancel
443           Cancel current state.
444
445       copy-clipboard
446           Copy text to clipboard.
447
448       cut-clipboard
449           Cut text to clipboard.
450
451       delete
452           Delete character under cursor.
453
454       down
455           Move cursor downwards.
456
457       end
458           Go to the end of the page/line.
459
460       end-of-buffer
461           Go to the last line of the buffer.
462
463       enter
464           Follow the current link.
465
466       home
467           Go to the start of the page/line.
468
469       kill-to-bol
470           Delete to beginning of line.
471
472       kill-to-eol
473           Delete to end of line.
474
475       kill-word-back
476           Delete backwards to start of word.
477
478       left
479           Move the cursor left.
480
481       move-backward-word
482           Move cursor before current word.
483
484       move-forward-word
485           Move cursor after current word.
486
487       next-item
488           Move to the next item.
489
490       open-external
491           Open in external editor.
492
493       paste-clipboard
494           Paste text from the clipboard.
495
496       previous-item
497           Move to the previous item.
498
499       redraw
500           Redraw the terminal.
501
502       right
503           Move the cursor right.
504
505       search-toggle-regex
506           Toggle regex matching (type-ahead searching).
507
508       up
509           Move cursor upwards.
510
511   MENU ACTIONS
512       cancel
513           Cancel current state.
514
515       delete
516           Delete character under cursor.
517
518       down
519           Move cursor downwards.
520
521       end
522           Go to the end of the page/line.
523
524       enter
525           Follow the current link.
526
527       expand
528           Expand item.
529
530       home
531           Go to the start of the page/line.
532
533       left
534           Move the cursor left.
535
536       mark-item
537           Mark item.
538
539       next-item
540           Move to the next item.
541
542       page-down
543           Move downwards by a page.
544
545       page-up
546           Move upwards by a page.
547
548       previous-item
549           Move to the previous item.
550
551       redraw
552           Redraw the terminal.
553
554       right
555           Move the cursor right.
556
557       search
558           Search for a text pattern.
559
560       select
561           Select current highlighted item.
562
563       unexpand
564           Collapse item.
565
566       up
567           Move cursor upwards.
568

DEFAULT BINDINGS

570       The default bindings are shown below. Any bindings in
571       ~/.elinks/elinks.conf will override these.
572
573   MAIN KEYS
574       Space
575           Move downwards by a page (move-page-down)
576
577       "#"
578           Search link text by typing ahead (search-typeahead)
579
580       "%"
581           Toggle usage of document specific colors (toggle-document-colors)
582
583       "*"
584           Toggle displaying of links to images (toggle-display-images)
585
586       ","
587           Open a Lua console (lua-console)
588
589       "."
590           Toggle displaying of links numbers (toggle-numbered-links)
591
592       "/"
593           Search for a text pattern (search)
594
595       ":"
596           Enter ex-mode (command line) (exmode)
597
598       "<"
599           Previous tab (tab-prev)
600
601       Alt-"<"
602           Move the current tab to the left (tab-move-left)
603
604       "="
605           Show information about the current page (document-info)
606
607       ">"
608           Next tab (tab-next)
609
610       Alt-">"
611           Move the current tab to the right (tab-move-right)
612
613       "?"
614           Search backwards for a text pattern (search-back)
615
616       "A"
617           Add a new bookmark using current link (add-bookmark-link)
618
619       Ctrl-"A"
620           Move to the start of the document (move-document-start)
621
622       Ctrl-"B"
623           Move upwards by a page (move-page-up)
624
625       "C"
626           Open cache manager (cache-manager)
627
628       "D"
629           Open download manager (download-manager)
630
631       "E"
632           Open "Go to URL" dialog box containing the current link URL
633           (goto-url-current-link)
634
635       Ctrl-"E"
636           Move to the end of the document (move-document-end)
637
638       "F"
639           Open form history manager (formhist-manager)
640
641       Ctrl-"F"
642           Move downwards by a page (move-page-down)
643
644       "G"
645           Open "Go to URL" dialog box containing the current URL
646           (goto-url-current)
647
648       "H"
649           Go to the homepage (goto-url-home)
650
651       "K"
652           Open cookie manager (cookie-manager)
653
654       Ctrl-"K"
655           Reload cookies file (cookies-load)
656
657       "L"
658           Open the link context menu (link-menu)
659
660       Ctrl-"L"
661           Redraw the terminal (redraw)
662
663       "N"
664           Find the previous occurrence of the current search text
665           (find-next-back)
666
667       Ctrl-"N"
668           Scroll down (scroll-down)
669
670       Ctrl-"P"
671           Scroll up (scroll-up)
672
673       "Q"
674           Quit without confirmation (really-quit)
675
676       Ctrl-"R"
677           Reload the current page (reload)
678
679       "T"
680           Open the current link in a new tab in the background
681           (open-link-in-new-tab-in-background)
682
683       "W"
684           Toggle wrapping of text (toggle-wrap-text)
685
686       "["
687           Scroll left (scroll-left)
688
689       "'"
690           Go at a specified mark (mark-goto)
691
692       "\"
693           Toggle rendering page as HTML / plain text (toggle-html-plain)
694
695       "]"
696           Scroll right (scroll-right)
697
698       "a"
699           Add a new bookmark (add-bookmark)
700
701       "b"
702           Move upwards by a page (move-page-up)
703
704       "c"
705           Close tab (tab-close)
706
707       "d"
708           Download the current link (link-download)
709
710       "e"
711           Open the tab menu (tab-menu)
712
713       "f"
714           Maximize the current frame (frame-maximize)
715
716       "g"
717           Open "Go to URL" dialog box (goto-url)
718
719       "h"
720           Open history manager (history-manager)
721
722       "k"
723           Open keybinding manager (keybinding-manager)
724
725       "l"
726           Jump to link (jump-to-link)
727
728       "m"
729           Set a mark (mark-set)
730
731       "n"
732           Find the next occurrence of the current search text (find-next)
733
734       "o"
735           Open options manager (options-manager)
736
737       "q"
738           Open a quit confirmation dialog box (quit)
739
740       "r"
741           Attempt to resume download of the current link
742           (link-download-resume)
743
744       "s"
745           Open bookmark manager (bookmark-manager)
746
747       "t"
748           Open a new tab (open-new-tab)
749
750       "u"
751           Go forward in history (history-move-forward)
752
753       "v"
754           View the current image (view-image)
755
756       "x"
757           Follow the current link, forcing reload of the target
758           (link-follow-reload)
759
760       "z"
761           Abort connection (abort-connection)
762
763       "{"
764           Scroll left (scroll-left)
765
766       "|"
767           Show information about the current page protocol headers
768           (header-info)
769
770       "}"
771           Scroll right (scroll-right)
772
773       Backspace
774           Backspace the last entered digit of the current prefix
775           (backspace-prefix)
776
777       Delete
778           Scroll down (scroll-down)
779
780       Down
781           Move to the next link (move-link-next)
782
783       End
784           Move to the end of the document (move-document-end)
785
786       Enter
787           Follow the current link (link-follow)
788
789       Ctrl-Enter
790           Follow the current link, forcing reload of the target
791           (link-follow-reload)
792
793       Escape
794           Activate the menu (menu)
795
796       F10
797           Open the File menu (file-menu)
798
799       F9
800           Activate the menu (menu)
801
802       Home
803           Move to the start of the document (move-document-start)
804
805       Insert
806           Scroll up (scroll-up)
807
808       Ctrl-Insert
809           Copy text to clipboard (copy-clipboard)
810
811       Left
812           Return to the previous document in history (history-move-back)
813
814       PageDown
815           Move downwards by a page (move-page-down)
816
817       PageUp
818           Move upwards by a page (move-page-up)
819
820       Right
821           Follow the current link (link-follow)
822
823       Ctrl-Right
824           Follow the current link, forcing reload of the target
825           (link-follow-reload)
826
827       Tab
828           Move to the next frame (frame-next)
829
830       Alt-Tab
831           Move to the previous frame (frame-prev)
832
833       Shift-Tab
834           Move to the previous frame (frame-prev)
835
836       Up
837           Move to the previous link (move-link-prev)
838
839   EDIT KEYS
840       Alt-"<"
841           Go to the first line of the buffer (beginning-of-buffer)
842
843       Alt-">"
844           Go to the last line of the buffer (end-of-buffer)
845
846       Ctrl-"A"
847           Go to the start of the page/line (home)
848
849       Alt-"b"
850           Move cursor before current word (move-backward-word)
851
852       Ctrl-"D"
853           Delete character under cursor (delete)
854
855       Ctrl-"E"
856           Go to the end of the page/line (end)
857
858       Alt-"f"
859           Move cursor after current word (move-forward-word)
860
861       Ctrl-"H"
862           Delete character in front of the cursor (backspace)
863
864       Ctrl-"K"
865           Delete to end of line (kill-to-eol)
866
867       Ctrl-"L"
868           Redraw the terminal (redraw)
869
870       Alt-"r"
871           Toggle regex matching (type-ahead searching) (search-toggle-regex)
872
873       Ctrl-"F"
874           Attempt to auto-complete a local file (auto-complete-file)
875
876       Ctrl-"R"
877           Attempt to unambiguously auto-complete the input
878           (auto-complete-unambiguous)
879
880       Ctrl-"T"
881           Open in external editor (open-external)
882
883       Ctrl-"U"
884           Delete to beginning of line (kill-to-bol)
885
886       Ctrl-"V"
887           Paste text from the clipboard (paste-clipboard)
888
889       Ctrl-"W"
890           Attempt to auto-complete the input (auto-complete)
891
892       Ctrl-"X"
893           Cut text to clipboard (cut-clipboard)
894
895       Alt-Backspace
896           Delete backwards to start of word (kill-word-back)
897
898       Backspace
899           Delete character in front of the cursor (backspace)
900
901       Delete
902           Delete character under cursor (delete)
903
904       Down
905           Move cursor downwards (down)
906
907       End
908           Go to the end of the page/line (end)
909
910       Enter
911           Follow the current link (enter)
912
913       Escape
914           Cancel current state (cancel)
915
916       F4
917           Open in external editor (open-external)
918
919       Home
920           Go to the start of the page/line (home)
921
922       Ctrl-Insert
923           Copy text to clipboard (copy-clipboard)
924
925       Left
926           Move the cursor left (left)
927
928       Right
929           Move the cursor right (right)
930
931       Tab
932           Move to the next item (next-item)
933
934       Alt-Tab
935           Move to the previous item (previous-item)
936
937       Shift-Tab
938           Move to the previous item (previous-item)
939
940       Up
941           Move cursor upwards (up)
942
943   MENU KEYS
944       Space
945           Select current highlighted item (select)
946
947       "*"
948           Mark item (mark-item)
949
950       "+"
951           Expand item (expand)
952
953       "-"
954           Collapse item (unexpand)
955
956       "/"
957           Search for a text pattern (search)
958
959       "="
960           Expand item (expand)
961
962       Ctrl-"A"
963           Go to the start of the page/line (home)
964
965       Ctrl-"B"
966           Move upwards by a page (page-up)
967
968       Ctrl-"E"
969           Go to the end of the page/line (end)
970
971       Ctrl-"F"
972           Move downwards by a page (page-down)
973
974       Ctrl-"L"
975           Redraw the terminal (redraw)
976
977       Ctrl-"N"
978           Move cursor downwards (down)
979
980       Ctrl-"P"
981           Move cursor upwards (up)
982
983       Alt-"V"
984           Move upwards by a page (page-up)
985
986       Ctrl-"V"
987           Move downwards by a page (page-down)
988
989       "["
990           Expand item (expand)
991
992       "]"
993           Collapse item (unexpand)
994
995       "_"
996           Collapse item (unexpand)
997
998       Delete
999           Delete character under cursor (delete)
1000
1001       Down
1002           Move cursor downwards (down)
1003
1004       End
1005           Go to the end of the page/line (end)
1006
1007       Enter
1008           Follow the current link (enter)
1009
1010       Escape
1011           Cancel current state (cancel)
1012
1013       Home
1014           Go to the start of the page/line (home)
1015
1016       Insert
1017           Mark item (mark-item)
1018
1019       Left
1020           Move the cursor left (left)
1021
1022       PageDown
1023           Move downwards by a page (page-down)
1024
1025       PageUp
1026           Move upwards by a page (page-up)
1027
1028       Right
1029           Move the cursor right (right)
1030
1031       Tab
1032           Move to the next item (next-item)
1033
1034       Alt-Tab
1035           Move to the previous item (previous-item)
1036
1037       Shift-Tab
1038           Move to the previous item (previous-item)
1039
1040       Up
1041           Move cursor upwards (up)
1042

AUTHOR

1044       This manual page was finally written by Peter Wang (one and a half
1045       years after writing the binding code), using excerpts by David
1046       Mediavilla. You can thank Petr Baudis for the subtle requests for
1047       documentation. Updated by Zas. Moved to asciidoc format and cleaned up
1048       by Jonas Fonseca.
1049

SEE ALSO

1051       elinks(1), elinks.conf(5)
1052
1053
1054
1055ELinks 0.12pre6                   10/26/2012                     ELINKSKEYS(5)
Impressum