1ELINKS.CONF(5)             ELinks configuration file            ELINKS.CONF(5)
2
3
4

NAME

6       elinks.conf - ELinks configuration file
7

SYNOPSIS

9           set     <option> = <value>
10           unset   <option>
11           bind    "<keymap>" "<key>" = "<action>"
12           include "<file>"
13

DESCRIPTION

15       The elinks.conf file contains configuration information for ELinks. It
16       can be used to configure the behaviour of ELinks in a wide variety of
17       ways: protocol behaviour, keybindings, colors used for rendering and
18       for the user interface.
19
20       It is read at startup and saved only when requested. All options
21       described in this document can be fully configured from within ELinks
22       so no editing of elinks.conf is needed.
23
24       Note that MIME-related options used for specifying handlers of various
25       MIME types are NOT described in this document. Documentation for these
26       options can be found at the ELinks homepage. Keybindings can also be
27       specified in elinks.conf. This is described in elinkskeys(5).
28
29

SYNTAX

31       The syntax of the configuration file is very simple. The elinks.conf
32       file is a free-form ASCII text file. The file may contain extra tabs
33       and newlines for formatting purposes. Keywords in the file are
34       case-sensitive. Comments may be placed anywhere within the file (except
35       within quotes). Comments begin with the # character and end at the end
36       of the line.
37
38

EXAMPLES

40       Some sample settings:
41
42
43           # Use asynchronous DNS resolver?
44           set connection.async_dns = 1
45           # horizontal text margin.
46           set document.browse.margin_width = 3
47           # Default document codepage.
48           set document.codepage.assume = "ISO-8859-1"
49           # User defined protocol handlers
50           set protocol.user.mailto.unix = "mutt %h -s \"%s\""
51

OPTIONS

53       Generated using output from ELinks version 0.12pre5.
54
55
56   bookmarks (Bookmarks)
57       Bookmark options.
58
59       bookmarks.file_format <num> (default: 0)
60           File format for bookmarks (affects both reading and saving):
61
62           ·   0 is the default native ELinks format
63
64           ·   1 is XBEL universal XML bookmarks format
65
66       bookmarks.folder_state [0|1] (default: 1)
67           When saving bookmarks also store whether folders are expanded or
68           not, so the look of the bookmark dialog is kept across ELinks
69           sessions. If disabled all folders will appear unexpanded next time
70           ELinks is run.
71
72   config (Configuration system)
73       Configuration handling options.
74
75       config.comments <num> (default: 3)
76           Amount of comments automatically written to the config file:
77
78           ·   0 is no comments are written
79
80           ·   1 is only the "blurb" (name+type) is written
81
82           ·   2 is only the description is written
83
84           ·   3 is full comments are written
85
86       config.indentation <num> (default: 2)
87           Shift width of one indentation level in the configuration file.
88           Zero means that no indentation is performed at all when saving the
89           configuration.
90
91       config.saving_style <num> (default: 3)
92           Determines what happens when you tell ELinks to save options:
93
94           ·   0 is only values of current options are altered
95
96           ·   1 is values of current options are altered and missing options
97               are added at the end of the file
98
99           ·   2 is the configuration file is rewritten from scratch
100
101           ·   3 is values of current options are altered and missing options
102               CHANGED during this ELinks session are added at the end of the
103               file
104
105       config.i18n [0|1] (default: 0)
106           If set to 1, comments in the configuration file will be translated
107           to the language used by UI. Note that if you have different
108           language set in different terminals, the language used in the
109           configuration file MAY be the same as on the terminal where you
110           saved the file, but it should be generally considered
111           unpredictable.
112
113       config.saving_style_w [0|1] (default: 0)
114           This is internal option used when displaying a warning about
115           obsolete config.saving_style. You shouldn´t touch it.
116
117       config.show_template [0|1] (default: 0)
118           Show template options in autocreated trees in the options manager
119           and save them to the configuration file.
120
121   connection (Connections)
122       Connection options.
123
124       connection.async_dns [0|1] (default: 1)
125           Whether to use asynchronous DNS resolving.
126
127       connection.max_connections <num> (default: 10)
128           Maximum number of concurrent connections.
129
130       connection.max_connections_to_host <num> (default: 2)
131           Maximum number of concurrent connections to a given host.
132
133       connection.receive_timeout <num> (default: 120)
134           Receive timeout (in seconds).
135
136       connection.retries <num> (default: 3)
137           Number of tries to establish a connection. Zero means try forever.
138
139       connection.try_ipv4 [0|1] (default: 1)
140           Whether to try to connect to a host over IPv4. Note that if
141           connection.try_ipv6 is enabled too, it takes precedence. And better
142           do not touch this at all unless you are sure what are you doing.
143
144           Note that you can also force a given protocol to be used on a
145           per-connection basis by using a URL in the style of e.g.
146           http4://elinks.cz/.
147
148       connection.try_ipv6 [0|1] (default: 1)
149           Whether to try to connect to a host over IPv6.
150
151           Note that you can also force a given protocol to be used on a
152           per-connection basis by using a URL in the style of e.g.
153           http6://elinks.cz/.
154
155       connection.unrestartable_receive_timeout <num> (default: 600)
156           Timeout for non-restartable connections (in seconds).
157
158   connection.ssl (SSL)
159       SSL options.
160
161       connection.ssl.cert_verify [0|1] (default: 0)
162           Verify the peer´s SSL certificate. Note that this needs extensive
163           configuration of OpenSSL by the user.
164
165   connection.ssl.client_cert (Client Certificates)
166       X509 client certificate options.
167
168       connection.ssl.client_cert.enable [0|1] (default: 0)
169           Enable or not the sending of X509 client certificates to servers
170           which request them.
171
172       connection.ssl.client_cert.file <str> (default: "")
173           The location of a file containing the client certificate and
174           unencrypted private key in PEM format. If unset, the file pointed
175           to by the X509_CLIENT_CERT variable is used instead.
176
177   cookies (Cookies)
178       Cookies options.
179
180       cookies.accept_policy <num> (default: 2)
181           Cookies accepting policy:
182
183           ·   0 is accept no cookies
184
185           ·   1 is ask for confirmation before accepting cookie
186
187           ·   2 is accept all cookies
188
189       cookies.max_age <num> (default: -1)
190           Cookie maximum age (in days):
191
192           ·   -1 is use cookie´s expiration date if any
193
194           ·   0 is force expiration at the end of session, ignoring cookie´s
195               expiration date
196
197           ·   1+ is use cookie´s expiration date, but limit age to the given
198               number of days
199
200       cookies.paranoid_security [0|1] (default: 0)
201           When enabled, we´ll require three dots in cookies domain for all
202           non-international domains (instead of just two dots). Some
203           countries have generic second level domains (eg. .com.pl, .co.uk)
204           and allowing sites to set cookies for these generic domains could
205           potentially be very bad. Note, it is off by default as it breaks a
206           lot of sites.
207
208       cookies.save [0|1] (default: 1)
209           Whether cookies should be loaded from and saved to disk.
210
211       cookies.resave [0|1] (default: 1)
212           Save cookies after each change in cookies list? No effect when
213           cookie saving (cookies.save) is off.
214
215   document (Document)
216       Document options.
217
218
219   document.browse (Browsing)
220       Document browsing options (mainly interactivity).
221
222       document.browse.margin_width <num> (default: 3)
223           Horizontal text margin.
224
225       document.browse.refresh [0|1] (default: 1)
226           Automatically follow document-specified refresh directives (´<meta>
227           refresh´ tags). Web-page authors use these to instruct the browser
228           to reload a document at a given interval or to load another page.
229           Regardless of the value the refresh URI is accessible as a link.
230
231           Use the document.browse.minimum_refresh_time to control the minimum
232           number of seconds a refresh will wait.
233
234       document.browse.minimum_refresh_time <num> (default: 1000)
235           The minimum number of milliseconds that should pass before
236           refreshing. If set to zero the document refresh time is used
237           unchanged. It can fix going back in history for some sites that use
238           refreshing with zero values.
239
240       document.browse.table_move_order [0|1] (default: 0)
241           Move by columns in table, instead of rows.
242
243   document.browse.accesskey (Access keys)
244       Options for handling of link access keys. An HTML document can use the
245       ACCESSKEY attribute to assign an access key to an element. When an
246       access key is pressed, the corresponding element will be given focus.
247
248       document.browse.accesskey.auto_follow [0|1] (default: 0)
249           Automatically follow a link or submit a form if appropriate
250           accesskey is pressed – this is the standard behaviour, but it´s
251           considered dangerous.
252
253       document.browse.accesskey.display [0|1] (default: 0)
254           Display access key in link info.
255
256       document.browse.accesskey.priority <num> (default: 0)
257           Priority of ´accesskey´ HTML attribute:
258
259           ·   0 is first try all normal bindings; if it fails, check
260               accesskey
261
262           ·   1 is first try only frame bindings; if it fails, check
263               accesskey
264
265           ·   2 is first check accesskey (this can be dangerous)
266
267   document.browse.forms (Forms)
268       Options for handling of the forms interaction.
269
270       document.browse.forms.auto_submit [0|1] (default: 1)
271           Automagically submit a form when enter is pressed with a text field
272           selected.
273
274       document.browse.forms.confirm_submit [0|1] (default: 1)
275           Ask for confirmation when submitting a form.
276
277       document.browse.forms.input_size <num> (default: 20)
278           Default form input size if none is specified.
279
280       document.browse.forms.insert_mode [0|1] (default: 1)
281           The setting for this option affects how key presses are handled
282           when one selects a text-input form-field. When enabled, one must
283           explicitly ´enter´ a selected text-field to edit it; this prevents
284           text fields from capturing key presses, such as presses of a scroll
285           key, when it is inadvertently selected. When disabled, key presses
286           are always inserted into a selected text field.
287
288       document.browse.forms.editor <str> (default: "")
289           Path to the executable that ELinks should launch when the user
290           requests to edit a textarea with an external editor.
291
292           If this is blank, ELinks will use the value of the environmental
293           variable $EDITOR. If $EDITOR is empty or not set, ELinks will then
294           default to vi.
295
296       document.browse.forms.show_formhist [0|1] (default: 0)
297           Ask if a login form should be saved to file or not. This option
298           only disables the dialog, already saved login forms are unaffected.
299
300   document.browse.images (Images)
301       Options for handling of images.
302
303       document.browse.images.display_style <num> (default: 2)
304           Display style for image tags when displayed:
305
306           ·   0 means always display IMG
307
308           ·   1 means always display filename
309
310           ·   2 means display alt/title attribute if possible, IMG if not
311
312           ·   3 means display alt/title attribute if possible, filename if
313               not
314
315       document.browse.images.filename_maxlen <num> (default: 0)
316           Maximum length of image filename when displayed:
317
318           ·   0 means always display full filename
319
320           ·   1-500 means display filename with this maximal length; if it is
321               longer, the middle is substituted by an asterisk
322
323       document.browse.images.image_link_tagging <num> (default: 1)
324           When to enclose image links:
325
326           ·   0 means never
327
328           ·   1 means never if alt or title are provided (old behavior)
329
330           ·   2 means always
331
332       document.browse.images.image_link_prefix <str> (default: "[")
333           Prefix string to use to mark image links.
334
335       document.browse.images.image_link_suffix <str> (default: "]")
336           Suffix string to use to mark image links.
337
338       document.browse.images.label_maxlen <num> (default: 0)
339           Maximum length of image label (alt/title):
340
341           ·   0 means always display full label
342
343           ·   1-500 means display label with this maximal length; if it is
344               longer, the middle is substituted by an asterisk
345
346       document.browse.images.show_as_links [0|1] (default: 0)
347           Display links to images without an alt attribute. If this option is
348           off, these images are completely invisible.
349
350       document.browse.images.show_any_as_links [0|1] (default: 1)
351           Display links to any images in the document, regardless of them
352           having an alt attribute or not. If this option is off, the alt
353           attribute contents is shown, but as normal text, not selectable as
354           a link.
355
356   document.browse.links (Links)
357       Options for handling of links to other documents.
358
359       document.browse.links.color_dirs [0|1] (default: 1)
360           Highlight links to directories in FTP and local directory listing.
361
362       document.browse.links.numbering [0|1] (default: 0)
363           Display numbers next to the links.
364
365       document.browse.links.target_blank <num> (default: 0)
366           Define how to handle links having target=_blank set:
367
368           ·   0 means open link in current tab
369
370           ·   1 means open link in new tab in foreground
371
372           ·   2 means open link in new tab in background
373
374           ·   3 means open link in new window
375
376       document.browse.links.use_tabindex [0|1] (default: 1)
377           Whether to navigate links using tabindex specified ordering. The
378           TABINDEX attribute in HTML elements specifies the order in which
379           links should receive focus when using the keyboard to navigate the
380           document.
381
382       document.browse.links.missing_fragment [0|1] (default: 1)
383           Open a message box when document has no tag with given id.
384
385       document.browse.links.number_keys_select_link <num> (default: 1)
386           Number keys select links rather than specify command prefixes. This
387           is a tristate:
388
389           ·   0 means never
390
391           ·   1 means if document.browse.links.numbering = 1
392
393           ·   2 means always
394
395       document.browse.links.warn_malicious [0|1] (default: 1)
396           When following a link the user ID part of the URI is checked and if
397           a maliciously crafted URI is detected a warning dialog will ask
398           before following the link.
399
400       document.browse.links.wraparound [0|1] (default: 0)
401           When pressing ´down´ on the last link, jump to the first one, and
402           vice versa.
403
404   document.browse.links.active_link (Active link)
405       Options for the active link.
406
407       document.browse.links.active_link.enable_color [0|1] (default: 0)
408           Enable use of the active link background and text color settings
409           instead of the link colors from the document.
410
411       document.browse.links.active_link.bold [0|1] (default: 0)
412           Make the active link text bold.
413
414       document.browse.links.active_link.invert [0|1] (default: 1)
415           Invert the fore- and background color so the link stands out.
416
417       document.browse.links.active_link.underline [0|1] (default: 0)
418           Underline the active link.
419
420   document.browse.links.active_link.colors (Colors)
421       Active link colors.
422
423       document.browse.links.active_link.colors.background <color|#rrggbb>
424       (default: blue)
425           Default background color.
426
427       document.browse.links.active_link.colors.text <color|#rrggbb> (default:
428       black)
429           Default text color.
430
431   document.browse.scrolling (Scrolling)
432       Scrolling options.
433
434       document.browse.scrolling.horizontal_extended [0|1] (default: 1)
435           Whether to allow horizontal scrolling when the document does not
436           extend off the screen. Useful for copy/paste operations.
437
438       document.browse.scrolling.horizontal_step <num> (default: 8)
439           Number of columns to scroll when a key bound to scroll-left or
440           scroll-right is pressed and no prefix was given.
441
442       document.browse.scrolling.margin <num> (default: 3)
443           Size of the virtual margin – when you click inside of that margin,
444           document scrolls in that direction.
445
446       document.browse.scrolling.vertical_step <num> (default: 2)
447           Number of lines to scroll when a key bound to scroll-up or
448           scroll-down is pressed and no prefix was given.
449
450   document.browse.search (Searching)
451       Options for searching.
452
453       document.browse.search.case [0|1] (default: 0)
454           Whether the search should match the document text while maintaining
455           case sensitivity.
456
457       document.browse.search.regex <num> (default: 0)
458           Enable searching with regular expressions:
459
460           ·   0 for plain text searching
461
462           ·   1 for basic regular expression searches
463
464           ·   2 for extended regular expression searches
465
466       document.browse.search.show_hit_top_bottom [0|1] (default: 1)
467           Whether to show a dialog when the search hits the top or bottom of
468           the document.
469
470       document.browse.search.wraparound [0|1] (default: 1)
471           Wrap around when searching. Currently only used for typeahead.
472
473       document.browse.search.show_not_found <num> (default: 2)
474           How to inform the user when nothing is matched:
475
476           ·   0 means do nothing
477
478           ·   1 means beep the terminal
479
480           ·   2 means pop up message box
481
482       document.browse.search.typeahead <num> (default: 0)
483           Start typeahead searching when an unbound key is pressed without
484           any modifiers. Note that most keys have default bindings, so this
485           feature will not be useful unless you unbind them.
486
487           ·   0 disables this feature; typeahead searching will only be used
488               when you press a key bound to search-typeahead or similar
489
490           ·   1 automatically starts typeahead searching thru link text
491
492           ·   2 automatically starts typeahead searching thru all document
493               text
494
495   document.cache (Cache)
496       Cache options.
497
498       document.cache.cache_redirects [0|1] (default: 0)
499           Cache even redirects sent by server (usually thru HTTP by a 302
500           HTTP code and a Location header). This was the original behaviour
501           for quite some time, but it causes problems in a situation very
502           common to various web login systems – frequently, when accessing a
503           certain location, they will redirect you to a login page if they
504           don´t receive an auth cookie, the login page then gives you the
505           cookie and redirects you back to the original page, but there you
506           have already cached redirect back to the login page! If this option
507           has value of 0, this malfunction is fixed, but occasionally you may
508           get superfluous (depends on how you take it ;-) requests to the
509           server. If this option has value of 1, experienced users can still
510           workaround it by clever combination of usage of reload, jumping
511           around in session history and hitting ctrl+enter.
512
513           Note that this option is checked when retrieving the information
514           from cache, not when saving it to cache – thus if you enable it,
515           even previous redirects will be taken from cache instead of asking
516           the server.
517
518       document.cache.ignore_cache_control [0|1] (default: 1)
519           Ignore Cache-Control and Pragma server headers. When set, the
520           document is cached even with ´Cache-Control: no-cache´.
521
522       document.cache.revalidation_interval <num> (default: -1)
523           Period in seconds that a cache entry is considered to be
524           up-to-date. When a document is loaded and this interval has elapsed
525           since the document was initially loaded or most recently
526           revalidated with the server, the server will be checked in case
527           there is a more up-to-date version of the document.
528
529           A value of -1 disables automatic revalidation.
530
531   document.cache.format (Formatted documents)
532       Format cache options.
533
534       document.cache.format.size <num> (default: 5)
535           Number of cached formatted pages. Do not get too generous here,
536           ´formatted´ means that all the accompanying structures are kept in
537           memory so that you get the cached document immediatelly, but these
538           structures may take a lot – 2x the size of the HTML source is
539           probably not unusual, but it can be even more if the document
540           consists of a lot of short lines (padded right, if possible) and
541           links and not much other markup. So if you set this to 256 and then
542           you don´t like your ELinks eating 90M, don´t come complaining to
543           us. ;-)
544
545           Also note that the format cache itself is not counted to the memory
546           cache size, but the HTML source of the formatted documents is
547           always cached, even if it is over the memory cache size threshold.
548           (Then of course no other documents can be cached.)
549
550   document.cache.memory (Memory cache)
551       Memory cache options.
552
553       document.cache.memory.size <num> (default: 1048576)
554           Memory cache size (in bytes).
555
556   document.codepage (Charset)
557       Charset options.
558
559       document.codepage.assume <codepage> (default: System)
560           Default document codepage. ´System´ stands for a codepage
561           determined by a selected locale.
562
563       document.codepage.force_assumed [0|1] (default: 0)
564           Ignore charset info sent by server.
565
566   document.colors (Default color settings)
567       Default document color settings.
568
569       document.colors.text <color|#rrggbb> (default: gray75)
570           Default text color.
571
572       document.colors.background <color|#rrggbb> (default: black)
573           Default background color.
574
575       document.colors.link <color|#rrggbb> (default: blue)
576           Default link color.
577
578       document.colors.vlink <color|#rrggbb> (default: yellow)
579           Default visited link color.
580
581       document.colors.image <color|#rrggbb> (default: darkolivegreen)
582           Default image link color.
583
584       document.colors.bookmark <color|#rrggbb> (default: hotpink)
585           Default bookmarked link color.
586
587       document.colors.dirs <color|#rrggbb> (default: yellow)
588           Default directory color.
589
590           See document.browse.links.color_dirs option.
591
592       document.colors.increase_contrast [0|1] (default: 1)
593           Increase the contrast between the foreground and background colors
594           to ensure readability. For example it disallows dark colors on a
595           black background. Note, this is different from ensuring the
596           contrast with the ensure_contrast option.
597
598       document.colors.ensure_contrast [0|1] (default: 1)
599           Makes sure that the back- and foreground colors are never equal.
600
601       document.colors.use_document_colors <num> (default: 2)
602           Use colors specified in document:
603
604           ·   0 is use always the default settings
605
606           ·   1 is use document colors if available, except background
607
608           ·   2 is use document colors, including background. This can mostly
609               look very impressive, but some sites will appear really ugly.
610               Note, that obviously if the background is not black, it will
611               break the behaviour of transparency.
612
613   document.css (Cascading Style Sheets)
614       Options concerning how to use CSS for styling documents.
615
616       document.css.enable [0|1] (default: 1)
617           Enable adding of CSS style info to documents.
618
619       document.css.import [0|1] (default: 1)
620           When enabled any external style sheets that are imported from
621           either CSS itself using the @import keyword or from the HTML using
622           <link> tags in the document header will also be downloaded.
623
624       document.css.stylesheet <str> (default: "")
625           The path to the file containing the default user defined Cascading
626           Style Sheet. It can be used to control the basic layout of HTML
627           documents. The path is assumed to be relative to ELinks´ home
628           directory.
629
630           Leave as "" to use built-in document styling.
631
632   document.download (Downloading)
633       Options regarding files downloading and handling.
634
635       document.download.directory <str> (default: "./")
636           Default download directory.
637
638       document.download.set_original_time [0|1] (default: 0)
639           Set the timestamp of each downloaded file to the timestamp stored
640           on the server.
641
642       document.download.overwrite <num> (default: 2)
643           Prevent overwriting the local files:
644
645           ·   0 is files will silently be overwritten
646
647           ·   1 is add a suffix .{number} (for example ´.1´) to the name
648
649           ·   2 is ask the user
650
651       document.download.notify_bell <num> (default: 0)
652           Audio notification when download is completed:
653
654           ·   0 is never
655
656           ·   1 is when background notification is active
657
658           ·   2 is always
659
660   document.dump (Dump output)
661       Dump output options.
662
663       document.dump.codepage <codepage> (default: System)
664           Codepage used in dump output. ´System´ stands for a codepage
665           determined by a selected locale.
666
667       document.dump.color_mode <num> (default: -1)
668           Color mode for dumps.
669
670           Some modes may have been disabled at compile time. The Setup ->
671           Terminal options dialog lists the modes supported by this
672           executable. If you select an unsupported mode, ELinks uses 16
673           colors.
674
675           The color modes are:
676
677           ·   -1 is standard dump mode
678
679           ·   0 is mono mode
680
681           ·   1 is 16 color mode
682
683           ·   2 is 88 color mode
684
685           ·   3 is 256 color mode
686
687           ·   4 is true color mode
688
689       document.dump.footer <str> (default: "")
690           Footer string used in dumps. %u is substituted by URL.
691
692       document.dump.header <str> (default: "")
693           Header string used in dumps. %u is substituted by URL.
694
695       document.dump.numbering [0|1] (default: 1)
696           Whether to print link numbers in dump output.
697
698       document.dump.references [0|1] (default: 1)
699           Whether to print references (URIs) of document links in dump
700           output.
701
702       document.dump.separator <str> (default: " ")
703           String which separates two dumps.
704
705       document.dump.width <num> (default: 80)
706           Width of screen in characters when dumping documents.
707
708   document.history (History)
709       History options.
710
711       document.history.keep_unhistory [0|1] (default: 1)
712           Keep unhistory ("forward history").
713
714   document.history.global (Global history)
715       Global history options.
716
717       document.history.global.enable [0|1] (default: 1)
718           Enable global history ("history of all pages visited").
719
720       document.history.global.max_items <num> (default: 1024)
721           Maximum number of entries in the global history.
722
723       document.history.global.display_type <num> (default: 0)
724           What to display in global history dialog:
725
726           ·   0 is URLs
727
728           ·   1 is page titles
729
730   document.html (HTML rendering)
731       Options concerning the display of HTML pages.
732
733       document.html.display_frames [0|1] (default: 1)
734           Display frames.
735
736       document.html.display_tables [0|1] (default: 1)
737           Display tables.
738
739       document.html.display_subs [0|1] (default: 1)
740           Display subscripts (as [thing]).
741
742       document.html.display_sups [0|1] (default: 1)
743           Display superscripts (as ^thing).
744
745       document.html.link_display <num> (default: 2)
746           How to render <link> tags from the HTML header:
747
748           ·   0 is nothing
749
750           ·   1 is title
751
752           ·   2 is name in addition
753
754           ·   3 is hreflang in addition
755
756           ·   4 is type in addition
757
758           ·   5 is everything
759
760       document.html.underline_links [0|1] (default: 0)
761           Underline links.
762
763       document.html.wrap_nbsp [0|1] (default: 0)
764           If set do not honour non breaking space (the nbsp entity) but allow
765           to wrap the text. This can help keeping the width of documents down
766           so no horizontal scrolling is needed.
767
768   document.plain (Plain rendering)
769       Options concerning the display of plain text pages.
770
771       document.plain.display_links [0|1] (default: 0)
772           Display URIs in the document as links.
773
774       document.plain.compress_empty_lines [0|1] (default: 0)
775           Compress successive empty lines to only one in displayed text.
776
777   document.uri_passing (URI passing)
778       Rules for passing URIs to external commands. When one rule is defined
779       the link and tab menu will have a menu item that makes it possible to
780       pass the the link, frame or tab URI to an external command. If several
781       rules are defined the link and tab menu will have a submenu of items
782       for each rule.
783
784       Note, this is mostly useful for launching graphical viewers, since
785       there is no support for releasing the terminal while the command runs.
786       The action and submenus are also available by binding keys to the
787       frame-external-command, the link-external-command, and the
788       tab-external-command actions.
789
790       document.uri_passing._template_ <str> (default: "")
791           A rule for passing URI to an external command. The format is:
792
793           ·   %c in the string means the current URL
794
795           ·   %% in the string means ´%´
796
797               Do not put single- or double-quotes around %c.
798
799   ecmascript (ECMAScript)
800       ECMAScript options.
801
802       ecmascript.enable [0|1] (default: 0)
803           Whether to run those scripts inside of documents.
804
805       ecmascript.error_reporting [0|1] (default: 0)
806           Open a message box when a script reports an error.
807
808       ecmascript.ignore_noscript [0|1] (default: 0)
809           Whether to ignore content enclosed by the <noscript> tag when
810           ECMAScript is enabled.
811
812       ecmascript.max_exec_time <num> (default: 5)
813           Maximum execution time in seconds for a script.
814
815       ecmascript.block_window_opening [0|1] (default: 0)
816           Whether to disallow scripts to open new windows or tabs.
817
818   infofiles (Information files)
819       Options for information files in ~/.elinks.
820
821       infofiles.save_interval <num> (default: 300)
822           Interval at which to trigger information files in ~/.elinks to be
823           saved to disk if they have changed (seconds; 0 to disable)
824
825       infofiles.secure_save [0|1] (default: 1)
826           First write data to unique temporary file, then rename this file
827           upon successfully finishing this. Note that this relates only to
828           config files, not downloaded files. You may want to disable it if
829           you are using some exotic permissions for concerned files. Secure
830           file saving is automagically disabled if file is symlink.
831
832           Warning: some systems (ie. OS/2, Win32) require that destination
833           file doesn´t exist when rename(3) is called, breaking atomicity,
834           and reducing reliability of this feature.
835
836       infofiles.secure_save_fsync [0|1] (default: 1)
837           When using secure file saving, call fsync(3), if the OS supports
838           it, to force the OS immediately to write the data to permanent
839           storage. This is optional for those who wish to avoid excessive
840           disk I/O.
841
842   mime (MIME)
843       MIME-related options (handlers of various MIME types).
844
845       mime.default_type <str> (default: "application/octet-stream")
846           Document MIME-type to assume by default (when we are unable to
847           guess it properly from known information about the document).
848
849   mime.extension (File extension associations)
850       Extension ↔ MIME type association.
851
852       mime.extension._template_ <str> (default: "")
853           MIME-type matching this file extension (´*´ is used here in place
854           of ´.´).
855
856   mime.handler (File type handlers)
857       A file type handler is a set of information about how to use an
858       external program to view a file. It is possible to refer to it for
859       several MIME types — e.g., you can define an ´image´ handler to which
860       mime.type.image.png, mime.type.image.jpeg, and so on will refer; or one
861       might define a handler for a more specific type of file — e.g., PDF
862       files. Note you must define both a MIME handler and a MIME type
863       association for it to work.
864
865
866   mime.handler._template_ (Template option folder)
867       Description of this handler.
868
869
870   mime.handler._template_._template_ (Template option folder)
871       System-specific handler description (ie. unix, unix-xwin, ...).
872
873       mime.handler._template_._template_.ask [0|1] (default: 1)
874           Ask before opening.
875
876       mime.handler._template_._template_.block [0|1] (default: 1)
877           Block the terminal when the handler is running.
878
879       mime.handler._template_._template_.program <str> (default: "")
880           External viewer for this file type. ´%´ in this string will be
881           substituted by a file name. Do not put single- or double-quotes
882           around the % sign.
883
884   mime.mailcap (Mailcap)
885       Options for mailcap support.
886
887       mime.mailcap.enable [0|1] (default: 1)
888           Enable mailcap support.
889
890       mime.mailcap.path <str> (default:
891       "~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap:/usr/share/mailcap:/usr/share/misc/mailcap")
892           Mailcap search path. Colon-separated list of files. Leave as "" to
893           use MAILCAP environment variable instead.
894
895       mime.mailcap.ask [0|1] (default: 1)
896           Ask before using the handlers defined by mailcap.
897
898       mime.mailcap.description <num> (default: 0)
899           Type of description to show in "what to do with this file" query
900           dialog:
901
902           ·   0 is show "mailcap"
903
904           ·   1 is show program to be run
905
906           ·   2 is show mailcap description field if any; "mailcap" otherwise
907
908       mime.mailcap.prioritize [0|1] (default: 1)
909           Prioritize entries by the order of the files in the mailcap path.
910           This means that wildcard entries (like: image/*) will also be
911           checked before deciding the handler.
912
913   mime.mimetypes (Mimetypes files)
914       Options for the support of mime.types files. These files can be used to
915       find the content type of a URL by looking at the extension of the file
916       name.
917
918       mime.mimetypes.enable [0|1] (default: 1)
919           Enable mime.types support.
920
921       mime.mimetypes.path <str> (default:
922       "~/.mime.types:/etc/mime.types:/usr/etc/mime.types:/usr/local/etc/mime.types:/usr/share/mime.types:/usr/share/misc/mime.types")
923           The search path for mime.types files. Colon-separated list of
924           files.
925
926   mime.type (MIME type associations)
927       Handler ↔ MIME type association. The first sub-tree is the MIME class
928       while the second sub-tree is the MIME type (ie. image/gif handler will
929       reside at mime.type.image.gif). Each MIME type option should contain
930       (case-sensitive) name of the MIME handler (its properties are stored at
931       mime.handler.<name>).
932
933
934   mime.type._template_ (Template option folder)
935       Handler matching this MIME-type class (´*´ is used here in place of
936       ´.´).
937
938       mime.type._template_._template_ <str> (default: "")
939           Handler matching this MIME-type name (´*´ is used here in place of
940           ´.´).
941
942   protocol (Protocols)
943       Protocol specific options.
944
945       protocol.no_proxy <str> (default: "")
946           Comma separated list of domains for which the proxy (HTTP/FTP)
947           should be disabled. Optionally, a port can be specified for some
948           domains as well. If it´s blank, NO_PROXY environment variable is
949           checked as well.
950
951   protocol.bittorrent (BitTorrent)
952       BitTorrent specific options.
953
954       protocol.bittorrent.piece_cache_size <num> (default: 1048576)
955           The maximum amount of memory used to hold recently downloaded
956           pieces.
957
958           Set to 0 to have unlimited size.
959
960       protocol.bittorrent.max_uploads <num> (default: 7)
961           The maximum number of uploads to allow at once.
962
963       protocol.bittorrent.min_uploads <num> (default: 2)
964           The minimum number of uploads which should at least be used for new
965           connections.
966
967       protocol.bittorrent.request_queue_size <num> (default: 5)
968           How many piece requests to continuously keep in queue. Pipelining
969           of requests is essential to saturate connections and get a good
970           connection performance and thus a faster download. However, a very
971           big queue size can lead to wasting bandwidth near the end of the
972           connection since remaining piece blocks will be requested from
973           multiple peers.
974
975       protocol.bittorrent.choke_interval <num> (default: 10)
976           The number of seconds between updating the connection state and
977           most importantly choke and unchoke peer connections. The choke
978           period should be big enough for newly unchoked connections to get
979           started but small enough to not allow freeriders too much room for
980           stealing bandwidth.
981
982       protocol.bittorrent.rarest_first_cutoff <num> (default: 4)
983           The number of pieces to obtain before switching piece selection
984           strategy from random to rarest first.
985
986       protocol.bittorrent.allow_blacklist [0|1] (default: 1)
987           Allow blacklisting of buggy peers.
988
989   protocol.bittorrent.ports (Port range)
990       Port range allowed to be used for listening on.
991
992       protocol.bittorrent.ports.min <num> (default: 6881)
993           The minimum port to try and listen on.
994
995       protocol.bittorrent.ports.max <num> (default: 6999)
996           The maximum port to try and listen on.
997
998   protocol.bittorrent.tracker (Tracker)
999       Tracker options.
1000
1001       protocol.bittorrent.tracker.compact [0|1] (default: 0)
1002           Whether to request that the tracker returns peer info in compact
1003           format. Note, the compact format only supports IPv4 addresses.
1004
1005       protocol.bittorrent.tracker.interval <num> (default: 0)
1006           The number of seconds to wait between periodically contacting the
1007           tracker for announcing progress and requesting more peers. Set to
1008           zero to use the interval requested by the tracker.
1009
1010       protocol.bittorrent.tracker.ip_address <str> (default: "")
1011           What IP address to report to the tracker. If set to "" no IP
1012           address will be sent and the tracker will automatically determine
1013           an appropriate IP address.
1014
1015       protocol.bittorrent.tracker.key <str> (default: "")
1016           An additional identification that is not shared with any users. It
1017           is intended to allow a client to prove their identity should their
1018           IP address change. It is an optional parameter, but some trackers
1019           require this parameter. If set to "" no user key will be sent to
1020           the tracker.
1021
1022       protocol.bittorrent.tracker.numwant <num> (default: 50)
1023           The maximum number of peers to request from the tracker. Set to 0
1024           to use the server default.
1025
1026       protocol.bittorrent.tracker.min_skip_size <num> (default: 20)
1027           The minimum number of peers to have in the current peer info pool
1028           before skipping requesting of more peers. I.e. setting numwant to
1029           zero. Set to 0 to not have any limit.
1030
1031   protocol.bittorrent.peerwire (Peer-wire)
1032       Lowlevel peer-wire options.
1033
1034       protocol.bittorrent.peerwire.connections <num> (default: 55)
1035           The maximum number of allowed connections to both active and
1036           non-active peers. By increasing the number of allowed connections,
1037           the chance of finding good peers to download from is increased.
1038           However, too many connections can lead to TCP congestion. If the
1039           maximum is reached all new incoming connections will be closed.
1040
1041       protocol.bittorrent.peerwire.max_message_length <num> (default:
1042       8388608)
1043           The maximum length of messages to accept over the wire. Larger
1044           values will cause the connection to be dropped.
1045
1046       protocol.bittorrent.peerwire.max_request_length <num> (default:
1047       8388608)
1048           The maximum length to allow for incoming requests. Larger requests
1049           will cause the connection to be dropped.
1050
1051       protocol.bittorrent.peerwire.request_length <num> (default: 16384)
1052           How many bytes to query for per request. This is complementary to
1053           the max_request_length option. If the configured length is bigger
1054           than the piece length it will be truncated.
1055
1056       protocol.bittorrent.peerwire.timeout <num> (default: 300)
1057           The number of seconds to wait before closing a socket on which
1058           nothing has been received or sent.
1059
1060       protocol.bittorrent.peerwire.pool_size <num> (default: 55)
1061           Maximum number of items in the peer pool. The peer pool contains
1062           information used for establishing connections to new peers.
1063
1064           Set to 0 to have unlimited size.
1065
1066   protocol.file (Local files)
1067       Options specific to local browsing.
1068
1069       protocol.file.allow_special_files [0|1] (default: 0)
1070           Whether to allow reading from non-regular files. Note this can be
1071           dangerous; reading /dev/urandom or /dev/zero can ruin your day!
1072
1073       protocol.file.show_hidden_files [0|1] (default: 1)
1074           When set to false, files with name starting with a dot will be
1075           hidden in local directory listings.
1076
1077       protocol.file.try_encoding_extensions [0|1] (default: 1)
1078           When set, if we can´t open a file named ´filename´, we´ll try to
1079           open ´filename´ with some encoding extension appended (ie.
1080           ´filename.gz´); it depends on the supported encodings.
1081
1082   protocol.file.cgi (Local CGI)
1083       Local CGI specific options.
1084
1085       protocol.file.cgi.path <str> (default: "")
1086           Colon separated list of directories, where CGI scripts are stored.
1087
1088       protocol.file.cgi.policy [0|1] (default: 0)
1089           Whether to execute local CGI scripts.
1090
1091   protocol.fsp (FSP)
1092       FSP specific options.
1093
1094       protocol.fsp.sort [0|1] (default: 1)
1095           Whether to sort entries in directory listings.
1096
1097   protocol.ftp (FTP)
1098       FTP specific options.
1099
1100       protocol.ftp.anon_passwd <str> (default: "some@host.domain")
1101           FTP anonymous password to be sent.
1102
1103       protocol.ftp.use_pasv [0|1] (default: 1)
1104           Use PASV instead of PORT (passive vs active mode, IPv4 only).
1105
1106       protocol.ftp.use_epsv [0|1] (default: 0)
1107           Use EPSV instead of EPRT (passive vs active mode, IPv6 only).
1108
1109   protocol.ftp.proxy (Proxy configuration)
1110       FTP proxy configuration.
1111
1112       protocol.ftp.proxy.host <str> (default: "")
1113           Host and port-number (host:port) of the FTP proxy, or blank. If
1114           it´s blank, FTP_PROXY environment variable is checked as well.
1115
1116   protocol.http (HTTP)
1117       HTTP-specific options.
1118
1119       protocol.http.accept_language <str> (default: "")
1120           Send Accept-Language header.
1121
1122       protocol.http.accept_ui_language [0|1] (default: 1)
1123           Request localised versions of documents from web-servers (using the
1124           Accept-Language header) using the language you have configured for
1125           ELinks´ user-interface (this also affects navigator.language
1126           ECMAScript value available to scripts). Note that some see this as
1127           a potential security risk because it tells web-masters and the FBI
1128           sniffers about your language preference.
1129
1130       protocol.http.compression [0|1] (default: 0)
1131           If enabled, the capability to receive compressed content (gzip
1132           and/or bzip2) is announced to the server, which usually sends the
1133           reply compressed, thus saving some bandwidth at slight CPU expense.
1134
1135           If ELinks displays a incomplete page or garbage, try disabling this
1136           option. If that helps, there may be a bug in the decompression part
1137           of ELinks. Please report such bugs.
1138
1139           If ELinks has been compiled without compression support, this
1140           option has no effect. To check the supported features, see Help ->
1141           About.
1142
1143       protocol.http.trace [0|1] (default: 0)
1144           If active, all HTTP requests are sent with TRACE as their method
1145           rather than GET or POST. This is useful for debugging of both
1146           ELinks and various server-side scripts — the server only returns
1147           the client´s request back to the client verbatim. Note that this
1148           type of request may not be enabled on all servers.
1149
1150       protocol.http.user_agent <str> (default: "ELinks/%v (textmode; %s;
1151       %t-%b)")
1152           Change the User Agent ID. That means identification string, which
1153           is sent to HTTP server when a document is requested. The ´textmode´
1154           token in the first field is our silent attempt to establish this as
1155           a standard for new textmode user agents, so that the webmasters can
1156           have just a single uniform test for these if they are e.g. pushing
1157           some lite version to them automagically.
1158
1159           Use " " if you don´t want any User-Agent header to be sent at all.
1160
1161           ·   %v in the string means ELinks version,
1162
1163           ·   %s in the string means system identification,
1164
1165           ·   %t in the string means size of the terminal,
1166
1167           ·   %b in the string means number of bars displayed by ELinks.
1168
1169   protocol.http.bugs (Server bug workarounds)
1170       Server-side HTTP bugs workarounds.
1171
1172       protocol.http.bugs.accept_charset [0|1] (default: 1)
1173           The Accept-Charset header is quite long and sending it can trigger
1174           bugs in some rarely found servers.
1175
1176       protocol.http.bugs.allow_blacklist [0|1] (default: 1)
1177           Allow blacklisting of buggy servers.
1178
1179       protocol.http.bugs.broken_302_redirect [0|1] (default: 1)
1180           Broken 302 redirect (violates RFC but compatible with Netscape).
1181           This is a problem for a lot of web discussion boards and the like.
1182           If they will do strange things to you, try to play with this.
1183
1184       protocol.http.bugs.post_no_keepalive [0|1] (default: 0)
1185           Disable keepalive connection after POST request.
1186
1187       protocol.http.bugs.http10 [0|1] (default: 0)
1188           Use HTTP/1.0 protocol instead of HTTP/1.1.
1189
1190   protocol.http.proxy (Proxy configuration)
1191       HTTP proxy configuration.
1192
1193       protocol.http.proxy.host <str> (default: "")
1194           Host and port-number (host:port) of the HTTP proxy, or blank. If
1195           it´s blank, HTTP_PROXY environment variable is checked as well.
1196
1197       protocol.http.proxy.user <str> (default: "")
1198           Proxy authentication username.
1199
1200       protocol.http.proxy.passwd <str> (default: "")
1201           Proxy authentication password.
1202
1203   protocol.http.referer (Referer sending)
1204       HTTP referer sending options. HTTP referer is a special header sent in
1205       the HTTP requests, which is supposed to contain the previous page
1206       visited by the browser.This way, the server can know what link did you
1207       follow when accessing that page. However, this behaviour can
1208       unfortunately considerably affect privacy and can lead even to a
1209       security problem on some badly designed web pages.
1210
1211       protocol.http.referer.policy <num> (default: 3)
1212           Mode of sending HTTP referer:
1213
1214           ·   0 is send no referer
1215
1216           ·   1 is send current URL as referer
1217
1218           ·   2 is send fixed fake referer
1219
1220           ·   3 is send previous URL as referer (correct, but insecure)
1221
1222       protocol.http.referer.fake <str> (default: "")
1223           Fake referer to be sent when policy is 2.
1224
1225   protocol.https (HTTPS)
1226       HTTPS-specific options.
1227
1228
1229   protocol.https.proxy (Proxy configuration)
1230       HTTPS proxy configuration.
1231
1232       protocol.https.proxy.host <str> (default: "")
1233           Host and port-number (host:port) of the HTTPS CONNECT proxy, or
1234           blank. If it´s blank, HTTPS_PROXY environment variable is checked
1235           as well.
1236
1237   protocol.nntp (NNTP)
1238       NNTP and news specific options.
1239
1240       protocol.nntp.server <str> (default: "")
1241           Used when resolving news: URIs. If set to the empty string the
1242           value of the NNTPSERVER environment variable will be used.
1243
1244       protocol.nntp.header_entries <str> (default:
1245       "Subject,From,Date,Message-ID,Newsgroups")
1246           Comma separated list of which entries in the article header to
1247           show. E.g. ´Subject´ and ´From´. All header entries can be read in
1248           the header info dialog.
1249
1250   protocol.rewrite (URI rewriting)
1251       Rules for rewriting URIs entered in the goto dialog. It makes it
1252       possible to define a set of prefixes that will be expanded if they
1253       match a string entered in the goto dialog. The prefixes can be dumb,
1254       meaning that they work only like URI abbreviations, or smart ones,
1255       making it possible to pass arguments to them like search engine
1256       keywords.
1257
1258       protocol.rewrite.default_template <str> (default: "")
1259           Default URI template used when the string entered in the goto
1260           dialog does not appear to be a URI or a filename (i.e. contains no
1261           ´.´, ´:´ or ´/´ characters), and does not match any defined
1262           prefixes. Set the value to "" to disable use of the default
1263           template rewrite rule.
1264
1265           ·   %c in the template means the current URL,
1266
1267           ·   %s in the template means the whole string from the goto dialog,
1268
1269           ·   %0,%1,...,%9 mean the 1st,2nd,...,10th space-delimited part of
1270               %s,
1271
1272           ·   %% in the template means ´%´.
1273
1274       protocol.rewrite.enable-dumb [0|1] (default: 1)
1275           Enable dumb prefixes – simple URI abbreviations which can be
1276           written to the Goto URL dialog instead of actual URIs – i.e. if you
1277           write ´elinks´ there, you are directed to http://elinks.cz/.
1278
1279       protocol.rewrite.enable-smart [0|1] (default: 1)
1280           Enable smart prefixes – URI templates triggered by writing given
1281           abbreviation to the Goto URL dialog followed by a list of arguments
1282           from which the actual URI is composed – i.e. ´gg:search keywords´
1283           or ´gn search keywords for news´.
1284
1285   protocol.rewrite.dumb (Dumb Prefixes)
1286       Dumb prefixes, see enable-dumb description for details.
1287
1288       protocol.rewrite.dumb._template_ <str> (default: "")
1289           Replacement URI for this dumbprefix:
1290
1291           ·   %c in the string means the current URL
1292
1293           ·   %% in the string means ´%´
1294
1295   protocol.rewrite.smart (Smart Prefixes)
1296       Smart prefixes, see enable-smart description for details.
1297
1298       protocol.rewrite.smart._template_ <str> (default: "")
1299           Replacement URI for this smartprefix:
1300
1301           ·   %c in the string means the current URL
1302
1303           ·   %s in the string means the whole argument to smartprefix
1304
1305           ·   %0,%1,...,%9 means argument 0, 1, ..., 9
1306
1307           ·   %% in the string means ´%´
1308
1309   protocol.user (User protocols)
1310       User protocols. Options in this tree specify external handlers for the
1311       appropriate protocols. Ie. protocol.user.mailto.unix.
1312
1313
1314   protocol.user._template_ (Template option folder)
1315       Handler (external program) for this protocol. Name the options in this
1316       tree after your system (ie. unix, unix-xwin).
1317
1318       protocol.user._template_._template_ <str> (default: "")
1319           Handler (external program) for this protocol and system.
1320
1321           ·   %f in the string means file name to include form data from
1322
1323           ·   %h in the string means hostname (or email address)
1324
1325           ·   %p in the string means port
1326
1327           ·   %d in the string means path (everything after the port)
1328
1329           ·   %s in the string means subject (?subject=<this>)
1330
1331           ·   %u in the string means the whole URL
1332
1333   terminal (Terminals)
1334       Terminal options.
1335
1336
1337   terminal._template_ (Template option folder)
1338       Options specific to this terminal type (according to $TERM value).
1339
1340       terminal._template_.type <num> (default: 0)
1341           Terminal type; matters mostly only when drawing frames and dialog
1342           box borders:
1343
1344           ·   0 is dumb terminal type, ASCII art
1345
1346           ·   1 is VT100, simple but portable
1347
1348           ·   2 is Linux, you get double frames and other goodies
1349
1350           ·   3 is KOI-8
1351
1352           ·   4 is FreeBSD
1353
1354       terminal._template_.latin1_title [0|1] (default: 1)
1355           When updating the window title of xterm or a similar terminal
1356           emulator, encode the title in ISO-8859-1 (Latin-1), rather than in
1357           the charset used for other text in the window. Cyrillic and other
1358           characters get replaced with Latin ones. Xterm requires this unless
1359           you explicitly enable UTF-8 titles in it.
1360
1361           If this option does not take effect immediately, try switching to a
1362           different page so that ELinks notices it needs to update the title.
1363
1364       terminal._template_.m11_hack [0|1] (default: 0)
1365           Switch fonts when drawing lines, enabling both local characters and
1366           lines working at the same time.  ELinks uses this option only if
1367           UTF-8 I/O is disabled and the terminal type is Linux or FreeBSD.
1368
1369       terminal._template_.utf_8_io [0|1] (default: 0)
1370           Enable I/O in UTF-8 for Unicode terminals. Note that currently,
1371           only the subset of UTF-8 according to terminal codepage is used.
1372           ELinks ignores this option if the terminal codepage is UTF-8.
1373
1374       terminal._template_.restrict_852 [0|1] (default: 0)
1375           Restrict the characters used when drawing lines. Makes sense only
1376           with linux terminals using the cp850/852 character sets.
1377
1378       terminal._template_.block_cursor [0|1] (default: 0)
1379           Move cursor to bottom right corner when done drawing. This is
1380           particularly useful when we have a block cursor, so that inversed
1381           text is displayed correctly.
1382
1383       terminal._template_.colors <num> (default: 0)
1384           The color mode controls what colors are used and how they are
1385           output to the terminal.
1386
1387           Some modes may have been disabled at compile time. The Setup ->
1388           Terminal options dialog lists the modes supported by this
1389           executable. If you select an unsupported mode, ELinks uses 16
1390           colors.
1391
1392           The color modes are:
1393
1394           ·   0 is mono mode, only 2 colors are used
1395
1396           ·   1 is 16 color mode, uses the common ANSI colors
1397
1398           ·   2 is 88 color mode, uses XTerm RGB codes
1399
1400           ·   3 is 256 color mode, uses XTerm RGB codes
1401
1402           ·   4 is true color mode, uses konsole RGB codes
1403
1404       terminal._template_.transparency [0|1] (default: 0)
1405           If we should not set the background to black. This is particularly
1406           useful when we have a terminal (typically in some windowing
1407           environment) with a background image or a transparent background –
1408           it will be visible in ELinks as well (but ELinks document color
1409           handling will still assume the background is black so if you have a
1410           bright background you might experience contrast problems). Note
1411           that this option makes sense only when colors are enabled.
1412
1413       terminal._template_.underline [0|1] (default: 0)
1414           If we should use underline or enhance the color instead.
1415
1416       terminal._template_.charset <codepage> (default: System)
1417           Codepage of charset used for displaying content on terminal.
1418           ´System´ stands for a codepage determined by a selected locale.
1419
1420   ui (User interface)
1421       User interface options.
1422
1423       ui.date_format <str> (default: "%b %e %H:%M")
1424           Date format to use in dialogs. See strftime(3).
1425
1426       ui.language <language> (default: "System")
1427           Language of user interface. ´System´ means that the language will
1428           be extracted from the environment dynamically.
1429
1430       ui.show_menu_bar_always [0|1] (default: 0)
1431           Always show menu bar on the screen.
1432
1433       ui.show_status_bar [0|1] (default: 1)
1434           Show status bar on the screen.
1435
1436       ui.show_title_bar [0|1] (default: 1)
1437           Show title bar on the screen.
1438
1439       ui.startup_goto_dialog [0|1] (default: 1)
1440           Pop up goto dialog in newly created tabs when there´s no homepage
1441           set. This means also showing goto dialog on startup.
1442
1443       ui.success_msgbox [0|1] (default: 1)
1444           When you pressed a Save button in some manager, this option will
1445           make sure that a box confirming success of the operation will pop
1446           up.
1447
1448       ui.window_title [0|1] (default: 1)
1449           Set the window title when running in a windowing environment in an
1450           xterm-like terminal. This way the document´s title is shown on the
1451           window titlebar.
1452
1453   ui.clock (Clock)
1454       Digital clock in the status bar.
1455
1456       ui.clock.enable [0|1] (default: 0)
1457           Whether to display a digital clock in the status bar.
1458
1459       ui.clock.format <str> (default: "[%H:%M]")
1460           Format string for the digital clock. See the strftime(3) manpage
1461           for details.
1462
1463   ui.colors (Color settings)
1464       Default user interface color settings.
1465
1466
1467   ui.colors.color (Color terminals)
1468       Color settings for color terminal.
1469
1470
1471   ui.colors.color.mainmenu (Main menu bar)
1472       Main menu bar colors.
1473
1474
1475   ui.colors.color.mainmenu.normal (Unselected main menu bar item)
1476       Unselected main menu bar item colors.
1477
1478       ui.colors.color.mainmenu.normal.text <color|#rrggbb> (default: black)
1479           Default text color.
1480
1481       ui.colors.color.mainmenu.normal.background <color|#rrggbb> (default:
1482       white)
1483           Default background color.
1484
1485   ui.colors.color.mainmenu.selected (Selected main menu bar item)
1486       Selected main menu bar item colors.
1487
1488       ui.colors.color.mainmenu.selected.text <color|#rrggbb> (default: green)
1489           Default text color.
1490
1491       ui.colors.color.mainmenu.selected.background <color|#rrggbb> (default:
1492       black)
1493           Default background color.
1494
1495   ui.colors.color.mainmenu.hotkey (Hotkey)
1496       Main menu hotkey colors.
1497
1498
1499   ui.colors.color.mainmenu.hotkey.normal (Unselected hotkey)
1500       Main menu unselected hotkey colors.
1501
1502       ui.colors.color.mainmenu.hotkey.normal.text <color|#rrggbb> (default:
1503       darkred)
1504           Default text color.
1505
1506       ui.colors.color.mainmenu.hotkey.normal.background <color|#rrggbb>
1507       (default: white)
1508           Default background color.
1509
1510   ui.colors.color.mainmenu.hotkey.selected (Selected hotkey)
1511       Main menu selected hotkey colors.
1512
1513       ui.colors.color.mainmenu.hotkey.selected.text <color|#rrggbb> (default:
1514       darkred)
1515           Default text color.
1516
1517       ui.colors.color.mainmenu.hotkey.selected.background <color|#rrggbb>
1518       (default: green)
1519           Default background color.
1520
1521   ui.colors.color.menu (Menu bar)
1522       Menu bar colors.
1523
1524
1525   ui.colors.color.menu.normal (Unselected menu item)
1526       Unselected menu item colors.
1527
1528       ui.colors.color.menu.normal.text <color|#rrggbb> (default: black)
1529           Default text color.
1530
1531       ui.colors.color.menu.normal.background <color|#rrggbb> (default: white)
1532           Default background color.
1533
1534   ui.colors.color.menu.selected (Selected menu item)
1535       Selected menu item colors.
1536
1537       ui.colors.color.menu.selected.text <color|#rrggbb> (default: black)
1538           Default text color.
1539
1540       ui.colors.color.menu.selected.background <color|#rrggbb> (default:
1541       green)
1542           Default background color.
1543
1544   ui.colors.color.menu.marked (Marked menu item)
1545       Marked menu item colors.
1546
1547       ui.colors.color.menu.marked.text <color|#rrggbb> (default: red)
1548           Default text color.
1549
1550       ui.colors.color.menu.marked.background <color|#rrggbb> (default: white)
1551           Default background color.
1552
1553   ui.colors.color.menu.hotkey (Hotkey)
1554       Menu item hotkey colors.
1555
1556
1557   ui.colors.color.menu.hotkey.normal (Unselected hotkey)
1558       Menu item unselected hotkey colors.
1559
1560       ui.colors.color.menu.hotkey.normal.text <color|#rrggbb> (default:
1561       darkred)
1562           Default text color.
1563
1564       ui.colors.color.menu.hotkey.normal.background <color|#rrggbb> (default:
1565       white)
1566           Default background color.
1567
1568   ui.colors.color.menu.hotkey.selected (Selected hotkey)
1569       Menu item selected hotkey colors.
1570
1571       ui.colors.color.menu.hotkey.selected.text <color|#rrggbb> (default:
1572       darkred)
1573           Default text color.
1574
1575       ui.colors.color.menu.hotkey.selected.background <color|#rrggbb>
1576       (default: green)
1577           Default background color.
1578
1579   ui.colors.color.menu.frame (Menu frame)
1580       Menu frame colors.
1581
1582       ui.colors.color.menu.frame.text <color|#rrggbb> (default: black)
1583           Default text color.
1584
1585       ui.colors.color.menu.frame.background <color|#rrggbb> (default: white)
1586           Default background color.
1587
1588   ui.colors.color.dialog (Dialog)
1589       Dialog colors.
1590
1591
1592   ui.colors.color.dialog.generic (Generic)
1593       Generic dialog colors.
1594
1595       ui.colors.color.dialog.generic.text <color|#rrggbb> (default: black)
1596           Default text color.
1597
1598       ui.colors.color.dialog.generic.background <color|#rrggbb> (default:
1599       white)
1600           Default background color.
1601
1602   ui.colors.color.dialog.frame (Frame)
1603       Dialog frame colors.
1604
1605       ui.colors.color.dialog.frame.text <color|#rrggbb> (default: black)
1606           Default text color.
1607
1608       ui.colors.color.dialog.frame.background <color|#rrggbb> (default:
1609       white)
1610           Default background color.
1611
1612   ui.colors.color.dialog.scrollbar (Scrollbar)
1613       Scrollbar colors.
1614
1615       ui.colors.color.dialog.scrollbar.text <color|#rrggbb> (default: black)
1616           Default text color.
1617
1618       ui.colors.color.dialog.scrollbar.background <color|#rrggbb> (default:
1619       blue)
1620           Default background color.
1621
1622   ui.colors.color.dialog.scrollbar-selected (Selected scrollbar)
1623       Scrollbar selected colors.
1624
1625       ui.colors.color.dialog.scrollbar-selected.text <color|#rrggbb>
1626       (default: black)
1627           Default text color.
1628
1629       ui.colors.color.dialog.scrollbar-selected.background <color|#rrggbb>
1630       (default: green)
1631           Default background color.
1632
1633   ui.colors.color.dialog.title (Title)
1634       Dialog title colors.
1635
1636       ui.colors.color.dialog.title.text <color|#rrggbb> (default: darkred)
1637           Default text color.
1638
1639       ui.colors.color.dialog.title.background <color|#rrggbb> (default:
1640       white)
1641           Default background color.
1642
1643   ui.colors.color.dialog.text (Text)
1644       Dialog text colors.
1645
1646       ui.colors.color.dialog.text.text <color|#rrggbb> (default: black)
1647           Default text color.
1648
1649       ui.colors.color.dialog.text.background <color|#rrggbb> (default: white)
1650           Default background color.
1651
1652   ui.colors.color.dialog.checkbox (Checkbox)
1653       Dialog checkbox colors.
1654
1655       ui.colors.color.dialog.checkbox.text <color|#rrggbb> (default: darkred)
1656           Default text color.
1657
1658       ui.colors.color.dialog.checkbox.background <color|#rrggbb> (default:
1659       white)
1660           Default background color.
1661
1662   ui.colors.color.dialog.checkbox-selected (Selected checkbox)
1663       Dialog selected checkbox colors.
1664
1665       ui.colors.color.dialog.checkbox-selected.text <color|#rrggbb> (default:
1666       yellow)
1667           Default text color.
1668
1669       ui.colors.color.dialog.checkbox-selected.background <color|#rrggbb>
1670       (default: green)
1671           Default background color.
1672
1673   ui.colors.color.dialog.checkbox-label (Checkbox label)
1674       Dialog checkbox label colors.
1675
1676       ui.colors.color.dialog.checkbox-label.text <color|#rrggbb> (default:
1677       black)
1678           Default text color.
1679
1680       ui.colors.color.dialog.checkbox-label.background <color|#rrggbb>
1681       (default: white)
1682           Default background color.
1683
1684   ui.colors.color.dialog.button (Button)
1685       Dialog button colors.
1686
1687       ui.colors.color.dialog.button.text <color|#rrggbb> (default: white)
1688           Default text color.
1689
1690       ui.colors.color.dialog.button.background <color|#rrggbb> (default:
1691       blue)
1692           Default background color.
1693
1694   ui.colors.color.dialog.button-selected (Selected button)
1695       Dialog selected button colors.
1696
1697       ui.colors.color.dialog.button-selected.text <color|#rrggbb> (default:
1698       yellow)
1699           Default text color.
1700
1701       ui.colors.color.dialog.button-selected.background <color|#rrggbb>
1702       (default: green)
1703           Default background color.
1704
1705   ui.colors.color.dialog.button-shortcut (Button shortcut)
1706       Dialog button colors.
1707
1708       ui.colors.color.dialog.button-shortcut.text <color|#rrggbb> (default:
1709       yellow)
1710           Default text color.
1711
1712       ui.colors.color.dialog.button-shortcut.background <color|#rrggbb>
1713       (default: blue)
1714           Default background color.
1715
1716   ui.colors.color.dialog.button-shortcut-selected (Selected button shortcut)
1717       Dialog selected button colors.
1718
1719       ui.colors.color.dialog.button-shortcut-selected.text <color|#rrggbb>
1720       (default: white)
1721           Default text color.
1722
1723       ui.colors.color.dialog.button-shortcut-selected.background
1724       <color|#rrggbb> (default: blue)
1725           Default background color.
1726
1727   ui.colors.color.dialog.field (Text field)
1728       Dialog text field colors.
1729
1730       ui.colors.color.dialog.field.text <color|#rrggbb> (default: white)
1731           Default text color.
1732
1733       ui.colors.color.dialog.field.background <color|#rrggbb> (default: blue)
1734           Default background color.
1735
1736   ui.colors.color.dialog.field-text (Text field text)
1737       Dialog field text colors.
1738
1739       ui.colors.color.dialog.field-text.text <color|#rrggbb> (default:
1740       yellow)
1741           Default text color.
1742
1743       ui.colors.color.dialog.field-text.background <color|#rrggbb> (default:
1744       blue)
1745           Default background color.
1746
1747   ui.colors.color.dialog.meter (Meter)
1748       Dialog meter colors.
1749
1750       ui.colors.color.dialog.meter.text <color|#rrggbb> (default: white)
1751           Default text color.
1752
1753       ui.colors.color.dialog.meter.background <color|#rrggbb> (default: blue)
1754           Default background color.
1755
1756   ui.colors.color.dialog.shadow (Shadow)
1757       Dialog shadow colors (see ui.shadows option).
1758
1759       ui.colors.color.dialog.shadow.text <color|#rrggbb> (default: black)
1760           Default text color.
1761
1762       ui.colors.color.dialog.shadow.background <color|#rrggbb> (default:
1763       black)
1764           Default background color.
1765
1766   ui.colors.color.title (Title bar)
1767       Title bar colors.
1768
1769
1770   ui.colors.color.title.title-bar (Generic title bar)
1771       Generic title bar colors.
1772
1773       ui.colors.color.title.title-bar.text <color|#rrggbb> (default: black)
1774           Default text color.
1775
1776       ui.colors.color.title.title-bar.background <color|#rrggbb> (default:
1777       white)
1778           Default background color.
1779
1780   ui.colors.color.title.title-text (Title bar text)
1781       Title bar text colors.
1782
1783       ui.colors.color.title.title-text.text <color|#rrggbb> (default: black)
1784           Default text color.
1785
1786       ui.colors.color.title.title-text.background <color|#rrggbb> (default:
1787       white)
1788           Default background color.
1789
1790   ui.colors.color.status (Status bar)
1791       Status bar colors.
1792
1793
1794   ui.colors.color.status.status-bar (Generic status bar)
1795       Generic status bar colors.
1796
1797       ui.colors.color.status.status-bar.text <color|#rrggbb> (default: black)
1798           Default text color.
1799
1800       ui.colors.color.status.status-bar.background <color|#rrggbb> (default:
1801       white)
1802           Default background color.
1803
1804   ui.colors.color.status.status-text (Status bar text)
1805       Status bar text colors.
1806
1807       ui.colors.color.status.status-text.text <color|#rrggbb> (default:
1808       black)
1809           Default text color.
1810
1811       ui.colors.color.status.status-text.background <color|#rrggbb> (default:
1812       white)
1813           Default background color.
1814
1815   ui.colors.color.tabs (Tabs bar)
1816       Tabs bar colors.
1817
1818
1819   ui.colors.color.tabs.unvisited (Unvisited tab)
1820       Tab colors for tabs that have not been selected since they completed
1821       loading.
1822
1823       ui.colors.color.tabs.unvisited.text <color|#rrggbb> (default: darkblue)
1824           Default text color.
1825
1826       ui.colors.color.tabs.unvisited.background <color|#rrggbb> (default:
1827       white)
1828           Default background color.
1829
1830   ui.colors.color.tabs.normal (Unselected tab)
1831       Unselected tab colors.
1832
1833       ui.colors.color.tabs.normal.text <color|#rrggbb> (default: black)
1834           Default text color.
1835
1836       ui.colors.color.tabs.normal.background <color|#rrggbb> (default: white)
1837           Default background color.
1838
1839   ui.colors.color.tabs.loading (Loading tab)
1840       Tab colors for tabs that are loading in the background.
1841
1842       ui.colors.color.tabs.loading.text <color|#rrggbb> (default: darkred)
1843           Default text color.
1844
1845       ui.colors.color.tabs.loading.background <color|#rrggbb> (default:
1846       white)
1847           Default background color.
1848
1849   ui.colors.color.tabs.selected (Selected tab)
1850       Selected tab colors.
1851
1852       ui.colors.color.tabs.selected.text <color|#rrggbb> (default: black)
1853           Default text color.
1854
1855       ui.colors.color.tabs.selected.background <color|#rrggbb> (default:
1856       green)
1857           Default background color.
1858
1859   ui.colors.color.tabs.separator (Tab separator)
1860       Tab separator colors.
1861
1862       ui.colors.color.tabs.separator.text <color|#rrggbb> (default: brown)
1863           Default text color.
1864
1865       ui.colors.color.tabs.separator.background <color|#rrggbb> (default:
1866       white)
1867           Default background color.
1868
1869   ui.colors.color.searched (Searched strings)
1870       Searched string highlight colors.
1871
1872       ui.colors.color.searched.text <color|#rrggbb> (default: black)
1873           Default text color.
1874
1875       ui.colors.color.searched.background <color|#rrggbb> (default: lime)
1876           Default background color.
1877
1878   ui.colors.mono (Non-color terminals)
1879       Color settings for non-color terminal.
1880
1881
1882   ui.colors.mono.mainmenu (Main menu bar)
1883       Main menu bar colors.
1884
1885
1886   ui.colors.mono.mainmenu.normal (Unselected main menu bar item)
1887       Unselected main menu bar item colors.
1888
1889       ui.colors.mono.mainmenu.normal.text <color|#rrggbb> (default: black)
1890           Default text color.
1891
1892       ui.colors.mono.mainmenu.normal.background <color|#rrggbb> (default:
1893       white)
1894           Default background color.
1895
1896   ui.colors.mono.mainmenu.selected (Selected main menu bar item)
1897       Selected main menu bar item colors.
1898
1899       ui.colors.mono.mainmenu.selected.text <color|#rrggbb> (default: gray)
1900           Default text color.
1901
1902       ui.colors.mono.mainmenu.selected.background <color|#rrggbb> (default:
1903       black)
1904           Default background color.
1905
1906   ui.colors.mono.mainmenu.hotkey (Hotkey)
1907       Main menu hotkey colors.
1908
1909
1910   ui.colors.mono.mainmenu.hotkey.normal (Unselected hotkey)
1911       Main menu unselected hotkey colors.
1912
1913       ui.colors.mono.mainmenu.hotkey.normal.text <color|#rrggbb> (default:
1914       black)
1915           Default text color.
1916
1917       ui.colors.mono.mainmenu.hotkey.normal.background <color|#rrggbb>
1918       (default: white)
1919           Default background color.
1920
1921   ui.colors.mono.mainmenu.hotkey.selected (Selected hotkey)
1922       Main menu selected hotkey colors.
1923
1924       ui.colors.mono.mainmenu.hotkey.selected.text <color|#rrggbb> (default:
1925       black)
1926           Default text color.
1927
1928       ui.colors.mono.mainmenu.hotkey.selected.background <color|#rrggbb>
1929       (default: white)
1930           Default background color.
1931
1932   ui.colors.mono.menu (Menu bar)
1933       Menu bar colors.
1934
1935
1936   ui.colors.mono.menu.normal (Unselected menu item)
1937       Unselected menu item colors.
1938
1939       ui.colors.mono.menu.normal.text <color|#rrggbb> (default: black)
1940           Default text color.
1941
1942       ui.colors.mono.menu.normal.background <color|#rrggbb> (default: white)
1943           Default background color.
1944
1945   ui.colors.mono.menu.selected (Selected menu item)
1946       Selected menu item colors.
1947
1948       ui.colors.mono.menu.selected.text <color|#rrggbb> (default: gray)
1949           Default text color.
1950
1951       ui.colors.mono.menu.selected.background <color|#rrggbb> (default:
1952       black)
1953           Default background color.
1954
1955   ui.colors.mono.menu.marked (Marked menu item)
1956       Marked menu item colors.
1957
1958       ui.colors.mono.menu.marked.text <color|#rrggbb> (default: gray)
1959           Default text color.
1960
1961       ui.colors.mono.menu.marked.background <color|#rrggbb> (default: white)
1962           Default background color.
1963
1964   ui.colors.mono.menu.hotkey (Hotkey)
1965       Menu item hotkey colors.
1966
1967
1968   ui.colors.mono.menu.hotkey.normal (Unselected hotkey)
1969       Menu item unselected hotkey colors.
1970
1971       ui.colors.mono.menu.hotkey.normal.text <color|#rrggbb> (default: gray)
1972           Default text color.
1973
1974       ui.colors.mono.menu.hotkey.normal.background <color|#rrggbb> (default:
1975       black)
1976           Default background color.
1977
1978   ui.colors.mono.menu.hotkey.selected (Selected hotkey)
1979       Menu item selected hotkey colors.
1980
1981       ui.colors.mono.menu.hotkey.selected.text <color|#rrggbb> (default:
1982       gray)
1983           Default text color.
1984
1985       ui.colors.mono.menu.hotkey.selected.background <color|#rrggbb>
1986       (default: black)
1987           Default background color.
1988
1989   ui.colors.mono.menu.frame (Menu frame)
1990       Menu frame colors.
1991
1992       ui.colors.mono.menu.frame.text <color|#rrggbb> (default: black)
1993           Default text color.
1994
1995       ui.colors.mono.menu.frame.background <color|#rrggbb> (default: white)
1996           Default background color.
1997
1998   ui.colors.mono.dialog (Dialog)
1999       Dialog colors.
2000
2001
2002   ui.colors.mono.dialog.generic (Generic)
2003       Generic dialog colors.
2004
2005       ui.colors.mono.dialog.generic.text <color|#rrggbb> (default: black)
2006           Default text color.
2007
2008       ui.colors.mono.dialog.generic.background <color|#rrggbb> (default:
2009       white)
2010           Default background color.
2011
2012   ui.colors.mono.dialog.frame (Frame)
2013       Dialog frame colors.
2014
2015       ui.colors.mono.dialog.frame.text <color|#rrggbb> (default: black)
2016           Default text color.
2017
2018       ui.colors.mono.dialog.frame.background <color|#rrggbb> (default: white)
2019           Default background color.
2020
2021   ui.colors.mono.dialog.scrollbar (Scrollbar)
2022       Scrollbar colors.
2023
2024       ui.colors.mono.dialog.scrollbar.text <color|#rrggbb> (default: white)
2025           Default text color.
2026
2027       ui.colors.mono.dialog.scrollbar.background <color|#rrggbb> (default:
2028       black)
2029           Default background color.
2030
2031   ui.colors.mono.dialog.scrollbar-selected (Selected scrollbar)
2032       Scrollbar selected colors.
2033
2034       ui.colors.mono.dialog.scrollbar-selected.text <color|#rrggbb> (default:
2035       black)
2036           Default text color.
2037
2038       ui.colors.mono.dialog.scrollbar-selected.background <color|#rrggbb>
2039       (default: white)
2040           Default background color.
2041
2042   ui.colors.mono.dialog.title (Title)
2043       Dialog title colors.
2044
2045       ui.colors.mono.dialog.title.text <color|#rrggbb> (default: gray)
2046           Default text color.
2047
2048       ui.colors.mono.dialog.title.background <color|#rrggbb> (default: black)
2049           Default background color.
2050
2051   ui.colors.mono.dialog.text (Text)
2052       Dialog text colors.
2053
2054       ui.colors.mono.dialog.text.text <color|#rrggbb> (default: black)
2055           Default text color.
2056
2057       ui.colors.mono.dialog.text.background <color|#rrggbb> (default: white)
2058           Default background color.
2059
2060   ui.colors.mono.dialog.checkbox (Checkbox)
2061       Dialog checkbox colors.
2062
2063       ui.colors.mono.dialog.checkbox.text <color|#rrggbb> (default: black)
2064           Default text color.
2065
2066       ui.colors.mono.dialog.checkbox.background <color|#rrggbb> (default:
2067       white)
2068           Default background color.
2069
2070   ui.colors.mono.dialog.checkbox-selected (Selected checkbox)
2071       Dialog selected checkbox colors.
2072
2073       ui.colors.mono.dialog.checkbox-selected.text <color|#rrggbb> (default:
2074       white)
2075           Default text color.
2076
2077       ui.colors.mono.dialog.checkbox-selected.background <color|#rrggbb>
2078       (default: black)
2079           Default background color.
2080
2081   ui.colors.mono.dialog.checkbox-label (Checkbox label)
2082       Dialog checkbox label colors.
2083
2084       ui.colors.mono.dialog.checkbox-label.text <color|#rrggbb> (default:
2085       black)
2086           Default text color.
2087
2088       ui.colors.mono.dialog.checkbox-label.background <color|#rrggbb>
2089       (default: white)
2090           Default background color.
2091
2092   ui.colors.mono.dialog.button (Button)
2093       Dialog button colors.
2094
2095       ui.colors.mono.dialog.button.text <color|#rrggbb> (default: black)
2096           Default text color.
2097
2098       ui.colors.mono.dialog.button.background <color|#rrggbb> (default:
2099       white)
2100           Default background color.
2101
2102   ui.colors.mono.dialog.button-selected (Selected button)
2103       Dialog selected button colors.
2104
2105       ui.colors.mono.dialog.button-selected.text <color|#rrggbb> (default:
2106       white)
2107           Default text color.
2108
2109       ui.colors.mono.dialog.button-selected.background <color|#rrggbb>
2110       (default: black)
2111           Default background color.
2112
2113   ui.colors.mono.dialog.button-shortcut (Button shortcut)
2114       Dialog button colors.
2115
2116       ui.colors.mono.dialog.button-shortcut.text <color|#rrggbb> (default:
2117       white)
2118           Default text color.
2119
2120       ui.colors.mono.dialog.button-shortcut.background <color|#rrggbb>
2121       (default: black)
2122           Default background color.
2123
2124   ui.colors.mono.dialog.button-shortcut-selected (Selected button shortcut)
2125       Dialog selected button colors.
2126
2127       ui.colors.mono.dialog.button-shortcut-selected.text <color|#rrggbb>
2128       (default: black)
2129           Default text color.
2130
2131       ui.colors.mono.dialog.button-shortcut-selected.background
2132       <color|#rrggbb> (default: white)
2133           Default background color.
2134
2135   ui.colors.mono.dialog.field (Text field)
2136       Dialog text field colors.
2137
2138       ui.colors.mono.dialog.field.text <color|#rrggbb> (default: gray)
2139           Default text color.
2140
2141       ui.colors.mono.dialog.field.background <color|#rrggbb> (default: black)
2142           Default background color.
2143
2144   ui.colors.mono.dialog.field-text (Text field text)
2145       Dialog field text colors.
2146
2147       ui.colors.mono.dialog.field-text.text <color|#rrggbb> (default: gray)
2148           Default text color.
2149
2150       ui.colors.mono.dialog.field-text.background <color|#rrggbb> (default:
2151       black)
2152           Default background color.
2153
2154   ui.colors.mono.dialog.meter (Meter)
2155       Dialog meter colors.
2156
2157       ui.colors.mono.dialog.meter.text <color|#rrggbb> (default: gray)
2158           Default text color.
2159
2160       ui.colors.mono.dialog.meter.background <color|#rrggbb> (default: black)
2161           Default background color.
2162
2163   ui.colors.mono.dialog.shadow (Shadow)
2164       Dialog shadow colors (see ui.shadows option).
2165
2166       ui.colors.mono.dialog.shadow.text <color|#rrggbb> (default: black)
2167           Default text color.
2168
2169       ui.colors.mono.dialog.shadow.background <color|#rrggbb> (default:
2170       black)
2171           Default background color.
2172
2173   ui.colors.mono.title (Title bar)
2174       Title bar colors.
2175
2176
2177   ui.colors.mono.title.title-bar (Generic title bar)
2178       Generic title bar colors.
2179
2180       ui.colors.mono.title.title-bar.text <color|#rrggbb> (default: gray)
2181           Default text color.
2182
2183       ui.colors.mono.title.title-bar.background <color|#rrggbb> (default:
2184       black)
2185           Default background color.
2186
2187   ui.colors.mono.title.title-text (Title bar text)
2188       Title bar text colors.
2189
2190       ui.colors.mono.title.title-text.text <color|#rrggbb> (default: gray)
2191           Default text color.
2192
2193       ui.colors.mono.title.title-text.background <color|#rrggbb> (default:
2194       black)
2195           Default background color.
2196
2197   ui.colors.mono.status (Status bar)
2198       Status bar colors.
2199
2200
2201   ui.colors.mono.status.status-bar (Generic status bar)
2202       Generic status bar colors.
2203
2204       ui.colors.mono.status.status-bar.text <color|#rrggbb> (default: black)
2205           Default text color.
2206
2207       ui.colors.mono.status.status-bar.background <color|#rrggbb> (default:
2208       white)
2209           Default background color.
2210
2211   ui.colors.mono.status.status-text (Status bar text)
2212       Status bar text colors.
2213
2214       ui.colors.mono.status.status-text.text <color|#rrggbb> (default: black)
2215           Default text color.
2216
2217       ui.colors.mono.status.status-text.background <color|#rrggbb> (default:
2218       white)
2219           Default background color.
2220
2221   ui.colors.mono.tabs (Tabs bar)
2222       Tabs bar colors.
2223
2224
2225   ui.colors.mono.tabs.unvisited (Unvisited tab)
2226       Tab colors for tabs that have not been selected since they completed
2227       loading.
2228
2229       ui.colors.mono.tabs.unvisited.text <color|#rrggbb> (default: gray)
2230           Default text color.
2231
2232       ui.colors.mono.tabs.unvisited.background <color|#rrggbb> (default:
2233       white)
2234           Default background color.
2235
2236   ui.colors.mono.tabs.normal (Unselected tab)
2237       Unselected tab colors.
2238
2239       ui.colors.mono.tabs.normal.text <color|#rrggbb> (default: black)
2240           Default text color.
2241
2242       ui.colors.mono.tabs.normal.background <color|#rrggbb> (default: white)
2243           Default background color.
2244
2245   ui.colors.mono.tabs.loading (Loading tab)
2246       Tab colors for tabs that are loading in the background.
2247
2248       ui.colors.mono.tabs.loading.text <color|#rrggbb> (default: gray)
2249           Default text color.
2250
2251       ui.colors.mono.tabs.loading.background <color|#rrggbb> (default: white)
2252           Default background color.
2253
2254   ui.colors.mono.tabs.selected (Selected tab)
2255       Selected tab colors.
2256
2257       ui.colors.mono.tabs.selected.text <color|#rrggbb> (default: gray)
2258           Default text color.
2259
2260       ui.colors.mono.tabs.selected.background <color|#rrggbb> (default:
2261       black)
2262           Default background color.
2263
2264   ui.colors.mono.tabs.separator (Tab separator)
2265       Tab separator colors.
2266
2267       ui.colors.mono.tabs.separator.text <color|#rrggbb> (default: gray)
2268           Default text color.
2269
2270       ui.colors.mono.tabs.separator.background <color|#rrggbb> (default:
2271       white)
2272           Default background color.
2273
2274   ui.colors.mono.searched (Searched strings)
2275       Searched string highlight colors.
2276
2277       ui.colors.mono.searched.text <color|#rrggbb> (default: black)
2278           Default text color.
2279
2280       ui.colors.mono.searched.background <color|#rrggbb> (default: white)
2281           Default background color.
2282
2283   ui.dialogs (Dialog settings)
2284       Dialogs-specific appearance and behaviour settings.
2285
2286       ui.dialogs.listbox_min_height <num> (default: 10)
2287           Minimal height of the listbox widget (used e.g. for bookmarks or
2288           global history).
2289
2290       ui.dialogs.shadows [0|1] (default: 0)
2291           Make dialogs drop shadows (the shadows are solid, you can adjust
2292           their color by ui.colors.*.dialog.shadow). You may also want to
2293           eliminate the wide borders by adjusting setup.h.
2294
2295       ui.dialogs.underline_hotkeys [0|1] (default: 0)
2296           Whether to underline hotkeys in menus to make them more visible.
2297           Requires that underlining is enabled for the terminal.
2298
2299       ui.dialogs.underline_button_shortcuts [0|1] (default: 0)
2300           Whether to underline button shortcuts to make them more visible.
2301           Requires that underlining is enabled for the terminal.
2302
2303   ui.leds (LEDs)
2304       LEDs (visual indicators) options.
2305
2306       ui.leds.enable [0|1] (default: 1)
2307           Enable LEDs. These visual indicators will inform you about various
2308           states.
2309
2310   ui.sessions (Sessions)
2311       Sessions settings.
2312
2313       ui.sessions.auto_restore [0|1] (default: 0)
2314           Automatically restore the session at start.
2315
2316           This feature requires bookmark support.
2317
2318       ui.sessions.auto_save [0|1] (default: 0)
2319           Automatically save the session when quitting.
2320
2321           This feature requires bookmark support.
2322
2323       ui.sessions.auto_save_foldername <str> (default: "Auto saved session")
2324           Name of the bookmarks folder used for auto saving and restoring
2325           session. The name has to be unique. Any folders with the same name
2326           will be deleted.
2327
2328           This only makes sense with bookmark support.
2329
2330       ui.sessions.homepage <str> (default: "")
2331           The URI to load either at startup time when no URI was given on the
2332           command line or when requested by the goto-url-home action. Set to
2333           "" if the environment variable WWW_HOME should be used as homepage
2334           URI instead.
2335
2336       ui.sessions.keep_session_active [0|1] (default: 0)
2337           Keep the session active even if the last terminal exits.
2338
2339       ui.sessions.snapshot [0|1] (default: 0)
2340           Automatically save a snapshot of all tabs periodically. This will
2341           periodically bookmark the tabs of each terminal in a separate
2342           folder for recovery after a crash.
2343
2344           This feature requires bookmark support.
2345
2346   ui.tabs (Window tabs)
2347       Window tabs settings.
2348
2349       ui.tabs.show_bar <num> (default: 1)
2350           Show tabs bar on the screen:
2351
2352           ·   0 means never
2353
2354           ·   1 means only if two or more tabs are open
2355
2356           ·   2 means always
2357
2358       ui.tabs.top [0|1] (default: 0)
2359           Whether display tab bar at top like other browsers do.
2360
2361       ui.tabs.wraparound [0|1] (default: 1)
2362           When moving right from the last tab, jump to the first one, and
2363           vice versa.
2364
2365       ui.tabs.confirm_close [0|1] (default: 0)
2366           When closing a tab show confirmation dialog.
2367
2368   ui.timer (Timer options)
2369       Timed action after certain interval of user inactivity. Someone can
2370       even find this useful, although you may not believe that.
2371
2372       ui.timer.enable <num> (default: 0)
2373           Whether to enable the timer or not:
2374
2375           ·   0 is don´t count down anything
2376
2377           ·   1 is count down, but don´t show the timer
2378
2379           ·   2 is count down and show the timer near LEDs
2380
2381       ui.timer.duration <num> (default: 86400)
2382           Inactivity timeout in seconds. The maximum of one day should be
2383           enough for just everyone (TM).
2384
2385       ui.timer.action <str> (default: "")
2386           Keybinding action to be triggered when timer reaches zero.
2387

SEE ALSO

2389       elinks(1), elinkskeys(5)
2390
2391
2392
2393
2394ELinks 0.12pre5                   07/07/2009                    ELINKS.CONF(5)
Impressum