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
12

DESCRIPTION

14       Key binding for elinks should be placed in the file
15       ~/.elinks/elinks.conf. Note that any information regarding their
16       format/structure may not be up-to-date. If you will discover that,
17       please feed us with a patch.
18
19       Key binding statements are of the form:
20
21
22           bind <keymap> <keystroke> = <action>
23       where:
24
25       <keymap>
26           is main, edit, or menu. The main keymap is used for general
27           browsing. The edit keymap is used for editing text fields. The menu
28           keymap is used for navigating menus.
29
30       <keystroke>
31           is a case sensitive key, which you can prefix with Ctrl-, Alt-, or
32           both.  Ctrl- must be followed by an uppercase key. See below for a
33           list of valid keys.
34
35       <action>
36           is what the key should do. The actions available are dependent on
37           the keymap, and are listed separately below.
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
45

EXAMPLE BINDINGS

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

KEYS

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

KEYMAP ACTIONS

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

DEFAULT BINDINGS

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

AUTHOR

1060       This manual page was finally written by Peter Wang (one and a half
1061       years after writing the binding code), using excerpts by David
1062       Mediavilla. You can thank Petr Baudis for the subtle requests for
1063       documentation. Updated by Zas. Moved to asciidoc format and cleaned up
1064       by Jonas Fonseca.
1065
1066

SEE ALSO

1068       elinks(1), elinks.conf(5)
1069
1070
1071
1072
1073ELinks 0.13.GIT                   03/29/2009                     ELINKSKEYS(5)
Impressum