elinks.conf.5

一个很有名的浏览器

.PD
.RE
.TP
\f3document.browse.images.show_as_links\f2 [0|1]\f1 (default: 0)
Display links to images without an alt attribute. If this option
is off, these images are completely invisible.
.TP
\f3document.browse.images.show_any_as_links\f2 [0|1]\f1 (default: 1)
Display links to any images in the document, regardless of them
having an alt attribute or not. If this option is off, the alt
attribute contents is shown, but as normal text, not selectable
as a link.
.SS Links (document.browse.links)
Options for handling of links to other documents.
.SS Active link (document.browse.links.active_link)
Options for the active link.
.SS Colors (document.browse.links.active_link.colors)
Active link colors.
.TP
\f3document.browse.links.active_link.colors.background\f2 <color|#rrggbb>\f1 (default: blue)
Default background color.
.TP
\f3document.browse.links.active_link.colors.text\f2 <color|#rrggbb>\f1 (default: black)
Default text color.
.TP
\f3document.browse.links.active_link.enable_color\f2 [0|1]\f1 (default: 0)
Enable use of the active link background and text color
settings instead of the link colors from the document.
.TP
\f3document.browse.links.active_link.bold\f2 [0|1]\f1 (default: 0)
Make the active link text bold.
.TP
\f3document.browse.links.active_link.invert\f2 [0|1]\f1 (default: 1)
Invert the fore- and background color so the link stands out.
.TP
\f3document.browse.links.active_link.underline\f2 [0|1]\f1 (default: 0)
Underline the active link.
.TP
\f3document.browse.links.color_dirs\f2 [0|1]\f1 (default: 1)
Highlight links to directories in FTP and local directory listing.
.TP
\f3document.browse.links.numbering\f2 [0|1]\f1 (default: 0)
Display numbers next to the links.
.TP
\f3document.browse.links.target_blank\f2 <num>\f1 (default: 0)
Define how to handle links having target=_blank set:
.RS
.PD 0
.TP
.B 0
means open link in current tab
.TP
.B 1
means open link in new tab in foreground
.TP
.B 2
means open link in new tab in background
.PD
.RE
.TP
\f3document.browse.links.use_tabindex\f2 [0|1]\f1 (default: 1)
Whether to navigate links using tabindex specified ordering.
The TABINDEX attribute in HTML elements specifies the order
in which links should receive focus when using the keyboard
to navigating the document.
.TP
\f3document.browse.links.number_keys_select_link\f2 <num>\f1 (default: 1)
Number keys select links rather than specify command prefixes. This
is a tristate:
.RS
.PD 0
.TP
.B 0
means never
.TP
.B 1
means if document.browse.links.numbering = 1
.TP
.B 2
means always
.PD
.RE
.TP
\f3document.browse.links.warn_malicious\f2 [0|1]\f1 (default: 1)
When following a link the user ID part of the URI is
checked and if a maliciously crafted URI is detected a
warning dialog will ask before following the link.
.TP
\f3document.browse.links.wraparound\f2 [0|1]\f1 (default: 0)
When pressing 'down' on the last link, jump at the first one, and
vice versa.
.SS Scrolling (document.browse.scrolling)
Scrolling options.
.TP
\f3document.browse.scrolling.horizontal_extended\f2 [0|1]\f1 (default: 1)
Whether to allow horizontal scrolling when the document
does not extend off the screen. Useful for copy/paste
operations.
.TP
\f3document.browse.scrolling.horizontal_step\f2 <num>\f1 (default: 8)
Number of columns to scroll when a key bound to scroll-left or scroll-
right is pressed and no prefix was given.
.PD
.RE
.TP
\f3document.browse.scrolling.margin\f2 <num>\f1 (default: 3)
Size of the virtual margin - when you click inside of that margin,
document scrolls in that direction.
.PD
.RE
.TP
\f3document.browse.scrolling.vertical_step\f2 <num>\f1 (default: 2)
Number of lines to scroll when a key bound to scroll-up or scroll-
down is pressed and no prefix was given.
.PD
.RE
.SS Searching (document.browse.search)
Options for searching.
.TP
\f3document.browse.search.case\f2 [0|1]\f1 (default: 0)
Whether the search should match the document text while maintaining
case sensitivity.
.TP
\f3document.browse.search.regex\f2 <num>\f1 (default: 0)
Enable searching with regular expressions:
.RS
.PD 0
.TP
.B 0
for plain text searching
.TP
.B 1
for basic regular expression searches
.TP
.B 2
for extended regular expression searches
.PD
.RE
.TP
\f3document.browse.search.show_hit_top_bottom\f2 [0|1]\f1 (default: 1)
Whether to show a dialog when the search hits top or bottom of the
document.
.TP
\f3document.browse.search.wraparound\f2 [0|1]\f1 (default: 1)
Wrap around when searching. Currently only used for typeahead.
.TP
\f3document.browse.search.show_not_found\f2 <num>\f1 (default: 2)
How to inform the user when nothing is matched:
.RS
.PD 0
.TP
.B 0
means do nothing
.TP
.B 1
means beep the terminal
.TP
.B 2
means pop up message box
.PD
.RE
.TP
\f3document.browse.search.typeahead\f2 <num>\f1 (default: 0)
Start typeahead searching when an unbound key is pressed without
any modifiers. Note that most keys have default bindings, so this
feature will not be useful unless you unbind them.
.PD
.RE
.TP
\f3when\f2 you\f1 (when you press a key bound to search-typeahead or similar)
1 automatically starts typeahead searching thru link text
2 automatically starts typeahead searching thru all document text
.TP
\f3document.browse.margin_width\f2 <num>\f1 (default: 3)
Horizontal text margin.
.PD
.RE
.TP
\f3document.browse.refresh\f2 [0|1]\f1 (default: 1)
Automatically follow document-specified refresh directives ('<meta>
refresh' tags). Web-page authors use these to instruct the browser
to reload a document at a given interval or to load another page.
Regardless of the value the refresh URI is accessible as a link.
Use the document.browse.minimum_refresh_time to control the minimum
number of seconds a refresh will wait.
.TP
\f3document.browse.minimum_refresh_time\f2 <num>\f1 (default: 1000)
The minimum number of milliseconds that should pass before
refreshing. If set to zero the document refresh time is used
unchanged. It can fix going back in history for some sites that
use refreshing with zero values.
.PD
.RE
.TP
\f3document.browse.table_move_order\f2 [0|1]\f1 (default: 0)
Move by columns in table, instead of rows.
.SS Cache (document.cache)
Cache options.
.SS Formatted documents (document.cache.format)
Format cache options.
.TP
\f3document.cache.format.size\f2 <num>\f1 (default: 5)
Number of cached formatted pages. Do not get too generous
here, 'formatted' means that all the accompanying structures
are kept in memory so that you get the cached document
immediatelly, but these structures may take a lot - 2x the
size of the HTML source is probably not unusual, but it can
be even more if the document consists of a lot of short lines
(padded right, if possible) and links and not much other markup.
So if you set this to 256 and then you don't like your ELinks
eating 90M, don't come complaining to us. ;-)
Also note that the format cache itself is not counted to the
memory cache size, but the HTML source of the formatted documents
is always cached, even if it is over the memory cache size
threshold. (Then of course no other documents can be cached.)
.PD
.RE
.SS Memory cache (document.cache.memory)
Memory cache options.
.TP
\f3document.cache.memory.size\f2 <num>\f1 (default: 1048576)
Memory cache size (in bytes).
.PD
.RE
.TP
\f3document.cache.cache_redirects\f2 [0|1]\f1 (default: 0)
Cache even redirects sent by server (usually thru HTTP by a 302
HTTP code and a Location header). This was the original behaviour
for a quite some time, but it causes problems in a situation very
common to various web login systems - frequently, when accessing
certain location, they will redirect you to a login page if they
don't receive an auth cookie, the login page then gives you the
cookie and redirects you back to the original page, but there you
have already cached redirect back to the login page! If this
option has value of 0, this malfunction is fixed, but occasionally
you may get superfluous (depends on how you take it ;-) requests to
the server. If this option has value of 1, experienced users can
still workaround it by clever combination of usage of reload,
jumping around in session history and hitting ctrl+enter.
Note that this option is checked when retrieving the information
from cache, not when saving it to cache - thus if you will enable
it, even previous redirects will be taken from cache instead of
asking the server.
.TP
\f3document.cache.ignore_cache_control\f2 [0|1]\f1 (default: 1)
Ignore Cache-Control and Pragma server headers.
When set, the document is cached even with 'Cache-Control: no-cache'.
.SS Charset (document.codepage)
Charset options.
.TP
\f3document.codepage.assume\f2 <codepage>\f1 (default: System)
Default document codepage. 'System' stands for
a codepage determined by a selected locale.
.TP
\f3document.codepage.force_assumed\f2 [0|1]\f1 (default: 0)
Ignore charset info sent by server.
.SS Default color settings (document.colors)
Default document color settings.
.TP
\f3document.colors.text\f2 <color|#rrggbb>\f1 (default: gray75)
Default text color.
.TP
\f3document.colors.background\f2 <color|#rrggbb>\f1 (default: black)
Default background color.
.TP
\f3document.colors.link\f2 <color|#rrggbb>\f1 (default: blue)
Default link color.
.TP
\f3document.colors.vlink\f2 <color|#rrggbb>\f1 (default: yellow)
Default visited link color.
.TP
\f3document.colors.image\f2 <color|#rrggbb>\f1 (default: darkolivegreen)
Default image link color.
.TP
\f3document.colors.bookmark\f2 <color|#rrggbb>\f1 (default: hotpink)
Default bookmarked link color.
.TP
\f3document.colors.dirs\f2 <color|#rrggbb>\f1 (default: yellow)
Default directory color.
See document.browse.links.color_dirs option.
.TP
\f3document.colors.allow_dark_on_black\f2 [0|1]\f1 (default: 0)
Allow dark colors on black background, and bright colors
on bright background. By default the colors have their contrast
increased, so that the foreground and the background do not have
too similar colors. This option turns this off. Note, this is
different from having it ensured through the ensure_contrast
option.
.TP
\f3document.colors.ensure_contrast\f2 [0|1]\f1 (default: 1)
Makes sure that the back- and foreground color are never equal.
.TP
\f3document.colors.use_document_colors\f2 <num>\f1 (default: 2)
Use colors specified in document:
.RS
.PD 0
.TP
.B 0
is use always the default settings
.TP
.B 1
is use document colors if available, except background
.TP
.B 2
is use document colors, including background. This can
mostly look very impressive, but some sites will appear
really ugly. Note, that obviously if the background is
not black, it will break the behaviour of transparency.
.PD
.RE
.SS Cascading Style Sheets (document.css)
Options concerning how to use CSS for styling documents.
.TP
\f3document.css.enable\f2 [0|1]\f1 (default: 1)
Enable adding of CSS style info to documents.
.TP
\f3document.css.import\f2 [0|1]\f1 (default: 1)
When enabled any external style sheets that are imported from
either CSS itself using the @import keyword or from the HTML using
<link> tags in the document header will also be downloaded.
.TP
\f3document.css.stylesheet\f2 <str>\f1 (default: "")
The path to the file containing the default user defined
Cascading Style Sheet. It can be used to control the basic
layout of HTML documents. The path is assumed to be relative
to ELinks' home directory.
Leave as "" to use built-in document styling.
.SS Downloading (document.download)
Options regarding files downloading and handling.
.TP
\f3document.download.directory\f2 <str>\f1 (default: "./")
Default download directory.
.TP
\f3document.download.set_original_time\f2 [0|1]\f1 (default: 0)
Set the timestamp of each downloaded file to the timestamp
stored on the server.
.TP
\f3document.download.overwrite\f2 <num>\f1 (default: 2)
Prevent overwriting the local files:
.RS
.PD 0
.TP
.B 0
is files will silently be overwritten
.TP
.B 1
is add a suffix .{number} (for example '.1') to the name
.TP
.B 2
is ask the user
.PD
.RE
.TP
\f3document.download.notify_bell\f2 <num>\f1 (default: 0)
Audio notification when download is completed:
.RS
.PD 0
.TP
.B 0
is never
.TP
.B 1
is when background notification is active
.TP
.B 2
is always
.PD
.RE
.SS Dump output (document.dump)
Dump output options.
.TP
\f3document.dump.codepage\f2 <codepage>\f1 (default: System)
Codepage used in dump output. 'System' stands for
a codepage determined by a selected locale.
.TP
\f3document.dump.header\f2 <str>\f1 (default: "")
Header string used in dumps. %u is substituted by URL.
.TP
\f3document.dump.footer\f2 <str>\f1 (default: "")
Footer string used in dumps. %u is substituted by URL.
.TP
\f3document.dump.separator\f2 <str>\f1 (document.dump.separator <str> (default: ")