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 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

EXAMPLE BINDINGS

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

KEYS

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

KEYMAP ACTIONS

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

DEFAULT BINDINGS

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

AUTHOR

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

SEE ALSO

1154       elinks(1), elinks.conf(5)
1155
1156
1157
1158
11592006-01-29                    ELinks keybindings                 ELINKSKEYS(5)
Impressum