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