elinks.conf.5

elinks下lynx是最重要的二个文本浏览器, 在linux下非常实用, elinks也是gentoo安装过程中默认使用的浏览器, 这是elinks源代码

.TP
document\&.browse\&.links\&.active_link\&.enable_color [0|1] (default: 0)
Enable use of the active link background and text color settings instead of the link colors from the document\&.

.TP
document\&.browse\&.links\&.active_link\&.bold [0|1] (default: 0)
Make the active link text bold\&.

.TP
document\&.browse\&.links\&.active_link\&.invert [0|1] (default: 1)
Invert the fore\- and background color so the link stands out\&.

.TP
document\&.browse\&.links\&.active_link\&.underline [0|1] (default: 0)
Underline the active link\&.

.TP
document\&.browse\&.links\&.color_dirs [0|1] (default: 1)
Highlight links to directories in FTP and local directory listing\&.

.TP
document\&.browse\&.links\&.numbering [0|1] (default: 0)
Display numbers next to the links\&.

.TP
document\&.browse\&.links\&.target_blank <num> (default: 0)
Define how to handle links having target=_blank set:

.RS
.TP 3
\(bu
0: means open link in current tab
.TP
\(bu
1: means open link in new tab in foreground
.TP
\(bu
2: means open link in new tab in background
.TP
\(bu
3: means open link in new window
.LP
.RE
.IP

.TP
document\&.browse\&.links\&.use_tabindex [0|1] (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
document\&.browse\&.links\&.missing_fragment [0|1] (default: 1)
Open a message box when document has no tag with given id\&.

.TP
document\&.browse\&.links\&.number_keys_select_link <num> (default: 1)
Number keys select links rather than specify command prefixes\&. This is a tristate:

.RS
.TP 3
\(bu
0: means never
.TP
\(bu
1: means if document\&.browse\&.links\&.numbering = 1
.TP
\(bu
2: means always
.LP
.RE
.IP

.TP
document\&.browse\&.links\&.warn_malicious [0|1] (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
document\&.browse\&.links\&.wraparound [0|1] (default: 0)
When pressing 'down' on the last link, jump at the first one, and vice versa\&.

.TP
document\&.browse\&.scrolling
Scrolling options\&.

.TP
document\&.browse\&.scrolling\&.horizontal_extended [0|1] (default: 1)
Whether to allow horizontal scrolling when the document does not extend off the screen\&. Useful for copy/paste operations\&.

.TP
document\&.browse\&.scrolling\&.horizontal_step <num> (default: 8)
Number of columns to scroll when a key bound to scroll\-left or scroll\- right is pressed and no prefix was given\&.

.TP
document\&.browse\&.scrolling\&.margin <num> (default: 3)
Size of the virtual margin \- when you click inside of that margin, document scrolls in that direction\&.

.TP
document\&.browse\&.scrolling\&.vertical_step <num> (default: 2)
Number of lines to scroll when a key bound to scroll\-up or scroll\- down is pressed and no prefix was given\&.

.TP
document\&.browse\&.search
Options for searching\&.

.TP
document\&.browse\&.search\&.case [0|1] (default: 0)
Whether the search should match the document text while maintaining case sensitivity\&.

.TP
document\&.browse\&.search\&.regex <num> (default: 0)
Enable searching with regular expressions:

.RS
.TP 3
\(bu
0: for plain text searching
.TP
\(bu
1: for basic regular expression searches
.TP
\(bu
2: for extended regular expression searches
.LP
.RE
.IP

.TP
document\&.browse\&.search\&.show_hit_top_bottom [0|1] (default: 1)
Whether to show a dialog when the search hits top or bottom of the document\&.

.TP
document\&.browse\&.search\&.wraparound [0|1] (default: 1)
Wrap around when searching\&. Currently only used for typeahead\&.

.TP
document\&.browse\&.search\&.show_not_found <num> (default: 2)
How to inform the user when nothing is matched:

.RS
.TP 3
\(bu
0: means do nothing
.TP
\(bu
1: means beep the terminal
.TP
\(bu
2: means pop up message box
.LP
.RE
.IP

.TP
document\&.browse\&.search\&.typeahead <num> (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\&.

.TP
when you (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
document\&.browse\&.margin_width <num> (default: 3)
Horizontal text margin\&.

.TP
document\&.browse\&.refresh [0|1] (default: 1)
Automatically follow document\-specified refresh directives (\fI<meta> refresh\fR 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
document\&.browse\&.minimum_refresh_time <num> (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\&.

.TP
document\&.browse\&.table_move_order [0|1] (default: 0)
Move by columns in table, instead of rows\&.

.TP
document\&.cache
Cache options\&.

.TP
document\&.cache\&.format
Format cache options\&.

.TP
document\&.cache\&.format\&.size <num> (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 \fIELinks\fR 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\&.)

.TP
document\&.cache\&.memory
Memory cache options\&.

.TP
document\&.cache\&.memory\&.size <num> (default: 1048576)
Memory cache size (in bytes)\&.

.TP
document\&.cache\&.cache_redirects [0|1] (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
document\&.cache\&.ignore_cache_control [0|1] (default: 1)
Ignore Cache\-Control and Pragma server headers\&. When set, the document is cached even with 'Cache\-Control: no\-cache'\&.

.TP
document\&.codepage
Charset options\&.

.TP
document\&.codepage\&.assume <codepage> (default: System)
Default document codepage\&. 'System' stands for a codepage determined by a selected locale\&.

.TP
document\&.codepage\&.force_assumed [0|1] (default: 0)
Ignore charset info sent by server\&.

.TP
document\&.colors
Default document color settings\&.

.TP
document\&.colors\&.text <color|#rrggbb> (default: gray75)
Default text color\&.

.TP
document\&.colors\&.background <color|#rrggbb> (default: black)
Default background color\&.

.TP
document\&.colors\&.link <color|#rrggbb> (default: blue)
Default link color\&.

.TP
document\&.colors\&.vlink <color|#rrggbb> (default: yellow)
Default visited link color\&.

.TP
document\&.colors\&.image <color|#rrggbb> (default: darkolivegreen)
Default image link color\&.

.TP
document\&.colors\&.bookmark <color|#rrggbb> (default: hotpink)
Default bookmarked link color\&.

.TP
document\&.colors\&.dirs <color|#rrggbb> (default: yellow)
Default directory color\&. See document\&.browse\&.links\&.color_dirs option\&.

.TP
document\&.colors\&.increase_contrast [0|1] (default: 1)
Increase the contrast between the foreground and background colors to ensure readability\&. For example it disallows dark colors on a black background\&. Note, this is different from ensuring the contrast with the ensure_contrast option\&.

.TP
document\&.colors\&.ensure_contrast [0|1] (default: 1)
Makes sure that the back\- and foreground color are never equal\&.

.TP
document\&.colors\&.use_document_colors <num> (default: 2)
Use colors specified in document:

.RS
.TP 3
\(bu
0: is use always the default settings
.TP
\(bu
1: is use document colors if available, except background
.TP
\(bu
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\&.
.LP
.RE
.IP

.TP
document\&.css
Options concerning how to use CSS for styling documents\&.

.TP
document\&.css\&.enable [0|1] (default: 1)
Enable adding of CSS style info to documents\&.

.TP
document\&.css\&.import [0|1] (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
document\&.css\&.stylesheet <str> (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 \fIELinks\fR' home directory\&. Leave as "" to use built\-in document styling\&.

.TP
document\&.download
Options regarding files downloading and handling\&.

.TP
document\&.download\&.directory <str> (default: "\&./")
Default download directory\&.

.TP
document\&.download\&.set_original_time [0|1] (default: 0)
Set the timestamp of each downloaded file to the timestamp stored on the server\&.

.TP
document\&.download\&.overwrite <num> (default: 2)
Prevent overwriting the local files:

.RS
.TP 3
\(bu
0: is files will silently be overwritten
.TP
\(bu
1: is add a suffix \&.{number} (for example '\&.1') to the name
.TP
\(bu
2: is ask the user
.LP
.RE
.IP

.TP
document\&.download\&.notify_bell <num> (default: 0)
Audio notification when download is completed:

.RS
.TP 3
\(bu
0: is never
.TP
\(bu
1: is when background notification is active
.TP
\(bu
2: is always
.LP
.RE
.IP

.TP
document\&.dump
Dump output options\&.

.TP
document\&.dump\&.codepage <codepage> (default: System)
Codepage used in dump output\&. 'System' stands for a codepage determined by a selected locale\&.

.TP
document\&.dump\&.footer <str> (default: "")
Footer string used in dumps\&. %u is substituted by URL\&.

.TP
document\&.dump\&.header <str> (default: "")
Header string used in dumps\&. %u is substituted by URL\&.

.TP
document\&.dump\&.numbering [0|1] (default: 1)
Whether to print link numbers in dump output\&.

.TP
document\&.dump\&.references [0|1] (default: 1)
Whether to print references (URIs) of document links in dump output\&.

.TP
document\&.dump\&.separator <str> (document\&.dump\&.separator <str> (default: "), document\&.dump\&.width <num> (default: 80)
Width of screen in characters when dumping documents\&.

.TP
document\&.history
History options\&.

.TP
document\&.history\&.global
Global history options\&.

.TP
document\&.history\&.global\&.enable [0|1] (default: 1)
Enable global history ("history of all pages visited")\&.

.TP
document\&.history\&.global\&.max_items <num> (default: 1024)
Maximum number of entries in the global history\&.

.TP
document\&.history\&.global\&.display_type <num> (default: 0)
What to display in global history dialog:

.RS
.TP 3
\(bu
0: is URLs
.TP
\(bu
1: is page titles
.LP
.RE
.IP

.TP
document\&.history\&.keep_unhistory [0|1] (default: 1)
Keep unhistory ("forward history")\&.

.TP
document\&.html
Options concerning the display of HTML pages\&.

.TP
document\&.html\&.display_frames [0|1] (default: 1)
Display frames\&.

.TP
document\&.html\&.display_tables [0|1] (default: 1)
Display tables\&.

.TP
document\&.html\&.display_subs [0|1] (default: 1)
Display subscripts (as [thing])\&.

.TP
document\&.html\&.display_sups [0|1] (default: 1)
Display superscripts (as ^thing)\&.

.TP
document\&.html\&.link_display <num> (default: 2)
How to render <link> tags from the HTML header:

.RS
.TP 3
\(bu
0: is nothing
.TP
\(bu
1: is title