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-menu
202           Open the link context menu.
203
204       link-form-menu
205           Open the form fields menu.
206
207       lua-console
208           Open a Lua console.
209
210       mark-goto
211           Go at a specified mark.
212
213       mark-set
214           Set a mark.
215
216       menu
217           Activate the menu.
218
219       move-cursor-down
220           Move cursor down.
221
222       move-cursor-left
223           Move cursor left.
224
225       move-cursor-line-start
226           Move cursor to the start of the line.
227
228       move-cursor-right
229           Move cursor right.
230
231       move-cursor-up
232           Move cursor up.
233
234       move-document-end
235           Move to the end of the document.
236
237       move-document-start
238           Move to the start of the document.
239
240       move-link-down
241           Move one link down.
242
243       move-link-down-line
244           Move to the next line with a link.
245
246       move-link-left
247           Move one link left.
248
249       move-link-left-line
250           Move one link left or to the previous link.
251
252       move-link-next
253           Move to the next link.
254
255       move-link-prev
256           Move to the previous link.
257
258       move-link-right
259           Move one link right.
260
261       move-link-right-line
262           Move one link right or to the next link.
263
264       move-link-up
265           Move one link up.
266
267       move-link-up-line
268           Move to the previous line with a link.
269
270       move-page-down
271           Move downwards by a page.
272
273       move-page-up
274           Move upwards by a page.
275
276       open-link-in-new-tab
277           Open the current link in a new tab.
278
279       open-link-in-new-tab-in-background
280           Open the current link in a new tab in the background.
281
282       open-link-in-new-window
283           Open the current link in a new window.
284
285       open-new-tab
286           Open a new tab.
287
288       open-new-tab-in-background
289           Open a new tab in the background.
290
291       open-new-window
292           Open a new window.
293
294       open-os-shell
295           Open an OS shell.
296
297       options-manager
298           Open options manager.
299
300       quit
301           Open a quit confirmation dialog box.
302
303       really-quit
304           Quit without confirmation.
305
306       redraw
307           Redraw the terminal.
308
309       reload
310           Reload the current page.
311
312       rerender
313           Re-render the current page.
314
315       reset-form
316           Reset form items to their initial values.
317
318       resource-info
319           Show information about the currently used resources.
320
321       save-as
322           Save the current document in source form.
323
324       save-formatted
325           Save the current document in formatted form.
326
327       save-options
328           Save options.
329
330       save-url-as
331           Save URL as.
332
333       scroll-down
334           Scroll down.
335
336       scroll-left
337           Scroll left.
338
339       scroll-right
340           Scroll right.
341
342       scroll-up
343           Scroll up.
344
345       search
346           Search for a text pattern.
347
348       search-back
349           Search backwards for a text pattern.
350
351       search-typeahead
352           Search link text by typing ahead.
353
354       search-typeahead-link
355           Search link text by typing ahead.
356
357       search-typeahead-text
358           Search document text by typing ahead.
359
360       search-typeahead-text-back
361           Search document text backwards by typing ahead.
362
363       show-term-options
364           Show terminal options dialog.
365
366       submit-form
367           Submit form.
368
369       submit-form-reload
370           Submit form and reload.
371
372       tab-close
373           Close tab.
374
375       tab-close-all-but-current
376           Close all tabs but the current one.
377
378       tab-external-command
379           Pass URI of current tab to external command.
380
381       tab-menu
382           Open the tab menu.
383
384       tab-move-left
385           Move the current tab to the left.
386
387       tab-move-right
388           Move the current tab to the right.
389
390       tab-next
391           Next tab.
392
393       tab-prev
394           Previous tab.
395
396       terminal-resize
397           Open the terminal resize dialog.
398
399       toggle-css
400           Toggle rendering of page using CSS.
401
402       toggle-display-images
403           Toggle displaying of links to images.
404
405       toggle-display-tables
406           Toggle rendering of tables.
407
408       toggle-document-colors
409           Toggle usage of document specific colors.
410
411       toggle-html-plain
412           Toggle rendering page as HTML / plain text.
413
414       toggle-mouse
415           Toggle mouse handling.
416
417       toggle-numbered-links
418           Toggle displaying of links numbers.
419
420       toggle-plain-compress-empty-lines
421           Toggle plain renderer compression of empty lines.
422
423       toggle-wrap-text
424           Toggle wrapping of text.
425
426       view-image
427           View the current image.
428
429   EDIT ACTIONS
430       auto-complete
431           Attempt to auto-complete the input.
432
433       auto-complete-file
434           Attempt to auto-complete a local file.
435
436       auto-complete-unambiguous
437           Attempt to unambiguously auto-complete the input.
438
439       backspace
440           Delete character in front of the cursor.
441
442       beginning-of-buffer
443           Go to the first line of the buffer.
444
445       cancel
446           Cancel current state.
447
448       copy-clipboard
449           Copy text to clipboard.
450
451       cut-clipboard
452           Cut text to clipboard.
453
454       delete
455           Delete character under cursor.
456
457       down
458           Move cursor downwards.
459
460       end
461           Go to the end of the page/line.
462
463       end-of-buffer
464           Go to the last line of the buffer.
465
466       enter
467           Follow the current link.
468
469       home
470           Go to the start of the page/line.
471
472       kill-to-bol
473           Delete to beginning of line.
474
475       kill-to-eol
476           Delete to end of line.
477
478       kill-word-back
479           Delete backwards to start of word.
480
481       left
482           Move the cursor left.
483
484       move-backward-word
485           Move cursor before current word.
486
487       move-forward-word
488           Move cursor after current word.
489
490       next-item
491           Move to the next item.
492
493       open-external
494           Open in external editor.
495
496       paste-clipboard
497           Paste text from the clipboard.
498
499       previous-item
500           Move to the previous item.
501
502       redraw
503           Redraw the terminal.
504
505       right
506           Move the cursor right.
507
508       search-toggle-regex
509           Toggle regex matching (type-ahead searching).
510
511       up
512           Move cursor upwards.
513
514   MENU ACTIONS
515       cancel
516           Cancel current state.
517
518       delete
519           Delete character under cursor.
520
521       down
522           Move cursor downwards.
523
524       end
525           Go to the end of the page/line.
526
527       enter
528           Follow the current link.
529
530       expand
531           Expand item.
532
533       home
534           Go to the start of the page/line.
535
536       left
537           Move the cursor left.
538
539       mark-item
540           Mark item.
541
542       next-item
543           Move to the next item.
544
545       page-down
546           Move downwards by a page.
547
548       page-up
549           Move upwards by a page.
550
551       previous-item
552           Move to the previous item.
553
554       redraw
555           Redraw the terminal.
556
557       right
558           Move the cursor right.
559
560       search
561           Search for a text pattern.
562
563       select
564           Select current highlighted item.
565
566       unexpand
567           Collapse item.
568
569       up
570           Move cursor upwards.
571

DEFAULT BINDINGS

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

AUTHOR

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

SEE ALSO

1056       elinks(1), elinks.conf(5)
1057
1058
1059
1060
1061ELinks 0.12pre5                   07/07/2009                     ELINKSKEYS(5)
Impressum