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 fully described in this document. Documentation for
26       these options can be found in the MIME chapter of the ELinks manual.
27       Keybindings can also be specified in elinks.conf. This is described in
28       elinkskeys(5).
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

EXAMPLES

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

OPTIONS

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

SEE ALSO

2354       elinks(1), elinkskeys(5)
2355
2356
2357
2358ELinks 0.12pre6                   10/28/2012                    ELINKS.CONF(5)
Impressum