1ELINKSKEYS(5) ELinks keybindings ELINKSKEYS(5)
2
3
4
6 elinkskeys - keybindings for ELinks
7
9 Information on how to configure keybinding and overview of the default
10 keybindings.
11
12
14 Key binding for elinks should be placed in the file
15 ~/.elinks/elinks.conf. Note that any information regarding their for‐
16 mat/structure may not be up-to-date. If you will discover that, please
17 feed us with a patch.
18
19
20 Key binding statements are of the form:
21
22 bind <keymap> <keystroke> = <action>
23
24
25 where:
26
27
28 <keymap>
29 is main, edit, or menu. The main keymap is used for general
30 browsing. The edit keymap is used for editing text fields. The
31 menu keymap is used for navigating menus.
32
33
34 <keystroke>
35 is a case sensitive key, which you can prefix with Ctrl- or
36 Alt-. Ctrl- must be followed by an uppercase key. See below for
37 a list of valid keys.
38
39
40 <action>
41 is what the key should do. The actions available are dependent
42 on the keymap, and are listed separately below.
43
44
45 All words/strings may all be quoted "like so". Backslashes are
46 escape characters, even if not between quotes. Lines beginning
47 with a hash character (#) are comments.
48
49
50 Keys can be unbound just by binding them to the special none
51 action. It may be of use if you accidentally type a key often.
52
53
55 Some sample keybindings:
56
57 bind "main" "v" = "view-image"
58 bind "main" "l" = "jump-to-link"
59 bind "main" "L" = "link-menu"
60 bind "main" "F10" = "file-menu"
61 bind "main" "F9" = "menu"
62 bind "main" "Escape" = "menu"
63 bind "edit" "Ctrl-R" = "auto-complete-unambiguous"
64 bind "edit" "Ctrl-W" = "auto-complete"
65 bind "edit" "Ctrl-K" = "kill-to-eol"
66 bind "menu" "Ctrl-B" = "page-up"
67 bind "menu" "PageUp" = "page-up"
68 bind "menu" "Ctrl-F" = "page-down"
69 bind "menu" "PageDown" = "page-down"
70 # ELinks with Lua support
71 bind "main" "," = "lua-console"
72
73
75 Valid keys are: alphanumeric characters, punctuation, Enter, Backspace,
76 Tab, Escape, Left, Right, Up, Down, Insert, Delete, Home, End, PageUp,
77 PageDown, F1 to F12.
78
79
80 Some keys will need to be quoted or escaped. For example, space can be
81 written as " " (quote space quote), and the quote itself as \" (back‐
82 slash quote). Backslash can be written as \\ (double backslash).
83
84
86 MAIN ACTIONS
87 abort-connection
88 Abort connection.
89
90
91 add-bookmark
92 Add a new bookmark.
93
94
95 add-bookmark-link
96 Add a new bookmark using current link.
97
98
99 add-bookmark-tabs
100 Bookmark all open tabs.
101
102
103 auth-manager
104 Open authentication manager.
105
106
107 bookmark-manager
108 Open bookmark manager.
109
110
111 cache-manager
112 Open cache manager.
113
114
115 cache-minimize
116 Free unused cache entries.
117
118
119 cookie-manager
120 Open cookie manager.
121
122
123 cookies-load
124 Reload cookies file.
125
126
127 copy-clipboard
128 Copy text to clipboard.
129
130
131 document-info
132 Show information about the current page.
133
134
135 download-manager
136 Open download manager.
137
138
139 exmode Enter ex-mode (command line).
140
141
142 file-menu
143 Open the File menu.
144
145
146 find-next
147 Find the next occurrence of the current search text.
148
149
150 find-next-back
151 Find the previous occurrence of the current search text.
152
153
154 forget-credentials
155 Forget authentication credentials.
156
157
158 formhist-manager
159 Open form history manager.
160
161
162 frame-external-command
163 Pass URI of current frame to external command.
164
165
166 frame-maximize
167 Maximize the current frame.
168
169
170 frame-next
171 Move to the next frame.
172
173
174 frame-prev
175 Move to the previous frame.
176
177
178 goto-url
179 Open "Go to URL" dialog box.
180
181
182 goto-url-current
183 Open "Go to URL" dialog box containing the current URL.
184
185
186 goto-url-current-link
187 Open "Go to URL" dialog box containing the current link URL.
188
189
190 goto-url-home
191 Go to the homepage.
192
193
194 header-info
195 Show information about the current page protocol headers.
196
197
198 history-manager
199 Open history manager.
200
201
202 history-move-back
203 Return to the previous document in history.
204
205
206 history-move-forward
207 Go forward in history.
208
209
210 jump-to-link
211 Jump to link.
212
213
214 keybinding-manager
215 Open keybinding manager.
216
217
218 kill-backgrounded-connections
219 Kill all backgrounded connections.
220
221
222 link-download
223 Download the current link.
224
225
226 link-download-image
227 Download the current image.
228
229
230 link-download-resume
231 Attempt to resume download of the current link.
232
233
234 link-external-command
235 Pass URI of current link to external command.
236
237
238 link-follow
239 Follow the current link.
240
241
242 link-follow-reload
243 Follow the current link, forcing reload of the target.
244
245
246 link-menu
247 Open the link context menu.
248
249
250 link-form-menu
251 Open the form fields menu.
252
253
254 lua-console
255 Open a Lua console.
256
257
258 mark-goto
259 Go at a specified mark.
260
261
262 mark-set
263 Set a mark.
264
265
266 menu Activate the menu.
267
268
269 move-cursor-down
270 Move cursor down.
271
272
273 move-cursor-left
274 Move cursor left.
275
276
277 move-cursor-right
278 Move cursor right.
279
280
281 move-cursor-up
282 Move cursor up.
283
284
285 move-document-end
286 Move to the end of the document.
287
288
289 move-document-start
290 Move to the start of the document.
291
292
293 move-link-down
294 Move one link down.
295
296
297 move-link-left
298 Move one link left.
299
300
301 move-link-next
302 Move to the next link.
303
304
305 move-link-prev
306 Move to the previous link.
307
308
309 move-link-right
310 Move one link right.
311
312
313 move-link-up
314 Move one link up.
315
316
317 move-page-down
318 Move downwards by a page.
319
320
321 move-page-up
322 Move upwards by a page.
323
324
325 open-link-in-new-tab
326 Open the current link in a new tab.
327
328
329 open-link-in-new-tab-in-background
330 Open the current link in a new tab in the background.
331
332
333 open-link-in-new-window
334 Open the current link in a new window.
335
336
337 open-new-tab
338 Open a new tab.
339
340
341 open-new-tab-in-background
342 Open a new tab in the background.
343
344
345 open-new-window
346 Open a new window.
347
348
349 open-os-shell
350 Open an OS shell.
351
352
353 options-manager
354 Open options manager.
355
356
357 quit Open a quit confirmation dialog box.
358
359
360 really-quit
361 Quit without confirmation.
362
363
364 redraw Redraw the terminal.
365
366
367 reload Reload the current page.
368
369
370 rerender
371 Re-render the current page.
372
373
374 reset-form
375 Reset form items to their initial values.
376
377
378 resource-info
379 Show information about the currently used resources.
380
381
382 save-as
383 Save the current document in source form.
384
385
386 save-formatted
387 Save the current document in formatted form.
388
389
390 save-options
391 Save options.
392
393
394 save-url-as
395 Save URL as.
396
397
398 scroll-down
399 Scroll down.
400
401
402 scroll-left
403 Scroll left.
404
405
406 scroll-right
407 Scroll right.
408
409
410 scroll-up
411 Scroll up.
412
413
414 search Search for a text pattern.
415
416
417 search-back
418 Search backwards for a text pattern.
419
420
421 search-typeahead
422 Search link text by typing ahead.
423
424
425 search-typeahead-link
426 Search link text by typing ahead.
427
428
429 search-typeahead-text
430 Search document text by typing ahead.
431
432
433 search-typeahead-text-back
434 Search document text backwards by typing ahead.
435
436
437 show-term-options
438 Show terminal options dialog.
439
440
441 submit-form
442 Submit form.
443
444
445 submit-form-reload
446 Submit form and reload.
447
448
449 tab-close
450 Close tab.
451
452
453 tab-close-all-but-current
454 Close all tabs but the current one.
455
456
457 tab-external-command
458 Pass URI of current tab to external command.
459
460
461 tab-menu
462 Open the tab menu.
463
464
465 tab-move-left
466 Move the current tab to the left.
467
468
469 tab-move-right
470 Move the current tab to the right.
471
472
473 tab-next
474 Next tab.
475
476
477 tab-prev
478 Previous tab.
479
480
481 terminal-resize
482 Open the terminal resize dialog.
483
484
485 toggle-css
486 Toggle rendering of page using CSS.
487
488
489 toggle-display-images
490 Toggle displaying of links to images.
491
492
493 toggle-display-tables
494 Toggle rendering of tables.
495
496
497 toggle-document-colors
498 Toggle usage of document specific colors.
499
500
501 toggle-html-plain
502 Toggle rendering page as HTML / plain text.
503
504
505 toggle-mouse
506 Toggle mouse handling.
507
508
509 toggle-numbered-links
510 Toggle displaying of links numbers.
511
512
513 toggle-plain-compress-empty-lines
514 Toggle plain renderer compression of empty lines.
515
516
517 toggle-wrap-text
518 Toggle wrapping of text.
519
520
521 view-image
522 View the current image.
523
524
525 EDIT ACTIONS
526 auto-complete
527 Attempt to auto-complete the input.
528
529
530 auto-complete-file
531 Attempt to auto-complete a local file.
532
533
534 auto-complete-unambiguous
535 Attempt to unambiguously auto-complete the input.
536
537
538 backspace
539 Delete character in front of the cursor.
540
541
542 beginning-of-buffer
543 Go to the first line of the buffer.
544
545
546 cancel Cancel current state.
547
548
549 copy-clipboard
550 Copy text to clipboard.
551
552
553 cut-clipboard
554 Delete text from clipboard.
555
556
557 delete Delete character under cursor.
558
559
560 down Move cursor downwards.
561
562
563 end Go to the end of the page/line.
564
565
566 end-of-buffer
567 Go to the last line of the buffer.
568
569
570 enter Follow the current link.
571
572
573 home Go to the start of the page/line.
574
575
576 kill-to-bol
577 Delete to beginning of line.
578
579
580 kill-to-eol
581 Delete to end of line.
582
583
584 left Move the cursor left.
585
586
587 next-item
588 Move to the next item.
589
590
591 open-external
592 Open in external editor.
593
594
595 paste-clipboard
596 Paste text from the clipboard.
597
598
599 previous-item
600 Move to the previous item.
601
602
603 redraw Redraw the terminal.
604
605
606 right Move the cursor right.
607
608
609 search-toggle-regex
610 Toggle regex matching (type-ahead searching).
611
612
613 up Move cursor upwards.
614
615
616 MENU ACTIONS
617 cancel Cancel current state.
618
619
620 delete Delete character under cursor.
621
622
623 down Move cursor downwards.
624
625
626 end Go to the end of the page/line.
627
628
629 enter Follow the current link.
630
631
632 expand Expand item.
633
634
635 home Go to the start of the page/line.
636
637
638 left Move the cursor left.
639
640
641 mark-item
642 Mark item.
643
644
645 next-item
646 Move to the next item.
647
648
649 page-down
650 Move downwards by a page.
651
652
653 page-up
654 Move upwards by a page.
655
656
657 previous-item
658 Move to the previous item.
659
660
661 redraw Redraw the terminal.
662
663
664 right Move the cursor right.
665
666
667 search Search for a text pattern.
668
669
670 select Select current highlighted item.
671
672
673 unexpand
674 Collapse item.
675
676
677 up Move cursor upwards.
678
679
681 The default bindings are shown below. Any bindings in
682 ~/.elinks/elinks.conf will override these.
683
684
685 MAIN KEYS
686 Space Move downwards by a page (move-page-down)
687
688
689 # Search link text by typing ahead (search-typeahead)
690
691
692 % Toggle usage of document specific colors (toggle-document-col‐
693 ors)
694
695
696 * Toggle displaying of links to images (toggle-display-images)
697
698
699 , Open a Lua console (lua-console)
700
701
702 . Toggle displaying of links numbers (toggle-numbered-links)
703
704
705 / Search for a text pattern (search)
706
707
708 : Enter ex-mode (command line) (exmode)
709
710
711 < Previous tab (tab-prev)
712
713
714 Alt-< Move the current tab to the left (tab-move-left)
715
716
717 = Show information about the current page (document-info)
718
719
720 > Next tab (tab-next)
721
722
723 Alt-> Move the current tab to the right (tab-move-right)
724
725
726 ? Search backwards for a text pattern (search-back)
727
728
729 A Add a new bookmark using current link (add-bookmark-link)
730
731
732 Ctrl-A Move to the start of the document (move-document-start)
733
734
735 Ctrl-B Move upwards by a page (move-page-up)
736
737
738 C Open cache manager (cache-manager)
739
740
741 D Open download manager (download-manager)
742
743
744 E Open \"Go to URL\" dialog box containing the current link URL
745 (goto-url-current-link)
746
747
748 Ctrl-E Move to the end of the document (move-document-end)
749
750
751 F Open form history manager (formhist-manager)
752
753
754 Ctrl-F Move downwards by a page (move-page-down)
755
756
757 G Open \"Go to URL\" dialog box containing the current URL
758 (goto-url-current)
759
760
761 H Go to the homepage (goto-url-home)
762
763
764 K Open cookie manager (cookie-manager)
765
766
767 Ctrl-K Reload cookies file (cookies-load)
768
769
770 L Open the link context menu (link-menu)
771
772
773 Ctrl-L Redraw the terminal (redraw)
774
775
776 N Find the previous occurrence of the current search text
777 (find-next-back)
778
779
780 Ctrl-N Scroll down (scroll-down)
781
782
783 Ctrl-P Scroll up (scroll-up)
784
785
786 Q Quit without confirmation (really-quit)
787
788
789 Ctrl-R Reload the current page (reload)
790
791
792 T Open the current link in a new tab in the background
793 (open-link-in-new-tab-in-background)
794
795
796 W Toggle wrapping of text (toggle-wrap-text)
797
798
799 [ Scroll left (scroll-left)
800
801
802 ´ Go at a specified mark (mark-goto)
803
804
805 \ Toggle rendering page as HTML / plain text (toggle-html-plain)
806
807
808 ] Scroll right (scroll-right)
809
810
811 a Add a new bookmark (add-bookmark)
812
813
814 b Move upwards by a page (move-page-up)
815
816
817 c Close tab (tab-close)
818
819
820 d Download the current link (link-download)
821
822
823 e Open the tab menu (tab-menu)
824
825
826 f Maximize the current frame (frame-maximize)
827
828
829 g Open \"Go to URL\" dialog box (goto-url)
830
831
832 h Open history manager (history-manager)
833
834
835 k Open keybinding manager (keybinding-manager)
836
837
838 l Jump to link (jump-to-link)
839
840
841 m Set a mark (mark-set)
842
843
844 n Find the next occurrence of the current search text (find-next)
845
846
847 o Open options manager (options-manager)
848
849
850 q Open a quit confirmation dialog box (quit)
851
852
853 r Attempt to resume download of the current link (link-down‐
854 load-resume)
855
856
857 s Open bookmark manager (bookmark-manager)
858
859
860 t Open a new tab (open-new-tab)
861
862
863 u Go forward in history (history-move-forward)
864
865
866 v View the current image (view-image)
867
868
869 x Follow the current link, forcing reload of the target (link-fol‐
870 low-reload)
871
872
873 z Abort connection (abort-connection)
874
875
876 { Scroll left (scroll-left)
877
878
879 | Show information about the current page protocol headers
880 (header-info)
881
882
883 } Scroll right (scroll-right)
884
885
886 Delete Scroll down (scroll-down)
887
888
889 Down Move to the next link (move-link-next)
890
891
892 End Move to the end of the document (move-document-end)
893
894
895 Enter Follow the current link (link-follow)
896
897
898 Ctrl-Enter
899 Follow the current link, forcing reload of the target (link-fol‐
900 low-reload)
901
902
903 Escape Activate the menu (menu)
904
905
906 F10 Open the File menu (file-menu)
907
908
909 F9 Activate the menu (menu)
910
911
912 Home Move to the start of the document (move-document-start)
913
914
915 Insert Scroll up (scroll-up)
916
917
918 Ctrl-Insert
919 Copy text to clipboard (copy-clipboard)
920
921
922 Left Return to the previous document in history (history-move-back)
923
924
925 PageDown
926 Move downwards by a page (move-page-down)
927
928
929 PageUp Move upwards by a page (move-page-up)
930
931
932 Right Follow the current link (link-follow)
933
934
935 Ctrl-Right
936 Follow the current link, forcing reload of the target (link-fol‐
937 low-reload)
938
939
940 Tab Move to the next frame (frame-next)
941
942
943 Alt-Tab
944 Move to the previous frame (frame-prev)
945
946
947 Up Move to the previous link (move-link-prev)
948
949
950 EDIT KEYS
951 Alt-< Go to the first line of the buffer (beginning-of-buffer)
952
953
954 Alt-> Go to the last line of the buffer (end-of-buffer)
955
956
957 Ctrl-A Go to the start of the page/line (home)
958
959
960 Ctrl-D Delete character under cursor (delete)
961
962
963 Ctrl-E Go to the end of the page/line (end)
964
965
966 Ctrl-H Delete character in front of the cursor (backspace)
967
968
969 Ctrl-K Delete to end of line (kill-to-eol)
970
971
972 Ctrl-L Redraw the terminal (redraw)
973
974
975 Alt-r Toggle regex matching (type-ahead searching) (search-tog‐
976 gle-regex)
977
978
979 Ctrl-F Attempt to auto-complete a local file (auto-complete-file)
980
981
982 Ctrl-R Attempt to unambiguously auto-complete the input (auto-com‐
983 plete-unambiguous)
984
985
986 Ctrl-T Open in external editor (open-external)
987
988
989 Ctrl-U Delete to beginning of line (kill-to-bol)
990
991
992 Ctrl-V Paste text from the clipboard (paste-clipboard)
993
994
995 Ctrl-W Attempt to auto-complete the input (auto-complete)
996
997
998 Ctrl-X Delete text from clipboard (cut-clipboard)
999
1000
1001 Backspace
1002 Delete character in front of the cursor (backspace)
1003
1004
1005 Delete Delete character under cursor (delete)
1006
1007
1008 Down Move cursor downwards (down)
1009
1010
1011 End Go to the end of the page/line (end)
1012
1013
1014 Enter Follow the current link (enter)
1015
1016
1017 Escape Cancel current state (cancel)
1018
1019
1020 F4 Open in external editor (open-external)
1021
1022
1023 Home Go to the start of the page/line (home)
1024
1025
1026 Ctrl-Insert
1027 Copy text to clipboard (copy-clipboard)
1028
1029
1030 Left Move the cursor left (left)
1031
1032
1033 Right Move the cursor right (right)
1034
1035
1036 Tab Move to the next item (next-item)
1037
1038
1039 Alt-Tab
1040 Move to the previous item (previous-item)
1041
1042
1043 Up Move cursor upwards (up)
1044
1045
1046 MENU KEYS
1047 Space Select current highlighted item (select)
1048
1049
1050 * Mark item (mark-item)
1051
1052
1053 + Expand item (expand)
1054
1055
1056 - Collapse item (unexpand)
1057
1058
1059 / Search for a text pattern (search)
1060
1061
1062 = Expand item (expand)
1063
1064
1065 Ctrl-A Go to the start of the page/line (home)
1066
1067
1068 Ctrl-B Move upwards by a page (page-up)
1069
1070
1071 Ctrl-E Go to the end of the page/line (end)
1072
1073
1074 Ctrl-F Move downwards by a page (page-down)
1075
1076
1077 Ctrl-L Redraw the terminal (redraw)
1078
1079
1080 Ctrl-N Move cursor downwards (down)
1081
1082
1083 Ctrl-P Move cursor upwards (up)
1084
1085
1086 Alt-V Move upwards by a page (page-up)
1087
1088
1089 Ctrl-V Move downwards by a page (page-down)
1090
1091
1092 [ Expand item (expand)
1093
1094
1095 ] Collapse item (unexpand)
1096
1097
1098 _ Collapse item (unexpand)
1099
1100
1101 Delete Delete character under cursor (delete)
1102
1103
1104 Down Move cursor downwards (down)
1105
1106
1107 End Go to the end of the page/line (end)
1108
1109
1110 Enter Follow the current link (enter)
1111
1112
1113 Escape Cancel current state (cancel)
1114
1115
1116 Home Go to the start of the page/line (home)
1117
1118
1119 Insert Mark item (mark-item)
1120
1121
1122 Left Move the cursor left (left)
1123
1124
1125 PageDown
1126 Move downwards by a page (page-down)
1127
1128
1129 PageUp Move upwards by a page (page-up)
1130
1131
1132 Right Move the cursor right (right)
1133
1134
1135 Tab Move to the next item (next-item)
1136
1137
1138 Alt-Tab
1139 Move to the previous item (previous-item)
1140
1141
1142 Up Move cursor upwards (up)
1143
1144
1146 This manual page was finally written by Peter Wang (one and a half
1147 years after writing the binding code), using excerpts by David Mediav‐
1148 illa. You can thank Petr Baudis for the subtle requests for documenta‐
1149 tion. Updated by Zas. Moved to asciidoc format and cleaned up by Jonas
1150 Fonseca.
1151
1152
1154 elinks(1), elinks.conf(5)
1155
1156
1157
1158
11592006-01-29 ELinks keybindings ELINKSKEYS(5)