elinks.conf.5

一个很有名的浏览器

.TP
\f3document.dump.width\f2 <num>\f1 (default: 80)
Width of screen in characters when dumping documents.
.PD
.RE
.SS History (document.history)
History options.
.SS Global history (document.history.global)
Global history options.
.TP
\f3document.history.global.enable\f2 [0|1]\f1 (default: 1)
Enable global history ("history of all pages visited").
.TP
\f3document.history.global.max_items\f2 <num>\f1 (default: 1024)
Maximum number of entries in the global history.
.PD
.RE
.TP
\f3document.history.global.display_type\f2 <num>\f1 (default: 0)
What to display in global history dialog:
.RS
.PD 0
.TP
.B 0
is URLs
.TP
.B 1
is page titles
.PD
.RE
.TP
\f3document.history.keep_unhistory\f2 [0|1]\f1 (default: 1)
Keep unhistory ("forward history").
.SS HTML rendering (document.html)
Options concerning the display of HTML pages.
.TP
\f3document.html.display_frames\f2 [0|1]\f1 (default: 1)
Display frames.
.TP
\f3document.html.display_tables\f2 [0|1]\f1 (default: 1)
Display tables.
.TP
\f3document.html.display_subs\f2 [0|1]\f1 (default: 1)
Display subscripts (as [thing]).
.TP
\f3document.html.display_sups\f2 [0|1]\f1 (default: 1)
Display superscripts (as ^thing).
.TP
\f3document.html.link_display\f2 <num>\f1 (default: 2)
How to render <link> tags from the HTML header:
.RS
.PD 0
.TP
.B 0
is nothing
.TP
.B 1
is title
.TP
.B 2
is name in addition
.TP
.B 3
is hreflang in addition
.TP
.B 4
is type in addition
.TP
.B 5
is everything
.PD
.RE
.TP
\f3document.html.underline_links\f2 [0|1]\f1 (default: 0)
Underline links.
.TP
\f3document.html.wrap_nbsp\f2 [0|1]\f1 (default: 0)
If set do not honour non breaking space (the nbsp entity)
but allow to wrap the text. This can help keeping the width
of documents down so no horizontal scrolling is needed.
.SS Plain rendering (document.plain)
Options concerning the display of plain text pages.
.TP
\f3document.plain.display_links\f2 [0|1]\f1 (default: 0)
Display URIs in the document as links.
.TP
\f3document.plain.compress_empty_lines\f2 [0|1]\f1 (default: 0)
Compress successive empty lines to only one in displayed text.
.SS URI passing (document.uri_passing)
Rules for passing URIs to external commands.
.TP
\f3document.uri_passing._template_\f2 <str>\f1 (default: "")
A rule for passing URI to an external command.
The format is:
%c in the string means the current URL
%% in the string means '%'
.SS ECMAScript (ecmascript)
ECMAScript options.
.TP
\f3ecmascript.enable\f2 [0|1]\f1 (default: 1)
Whether to run those scripts inside of documents.
.TP
\f3ecmascript.error_reporting\f2 [0|1]\f1 (default: 0)
Open a message box when a script reports an error.
.TP
\f3ecmascript.max_exec_time\f2 <num>\f1 (default: 5)
Maximum execution time in seconds for a script.
.PD
.RE
.TP
\f3ecmascript.block_window_opening\f2 [0|1]\f1 (default: 0)
Whether to disallow scripts to open new windows or tabs.
.SS Information files (infofiles)
Options for information files in ~/.elinks.
.TP
\f3infofiles.save_interval\f2 <num>\f1 (default: 300)
Interval at which to trigger information files in ~/.elinks
to be saved to disk if they has changed (seconds; 0 to disable)
.PD
.RE
.TP
\f3infofiles.secure_save\f2 [0|1]\f1 (default: 1)
First write data to unique temporary file, then rename this file
upon successfully finishing this. Note that this relates only to
config files, not downloaded files. You may want to disable
it if you are using some exotic permissions for concerned files.
Secure file saving is automagically disabled if file is symlink.
Warning: some systems (ie. OS/2, Win32) require that destination
file doesn't exist when rename(3) is called, breaking atomicity,
and reducing reliability of this feature.
.TP
\f3infofiles.secure_save_fsync\f2 [0|1]\f1 (default: 1)
When using secure file saving, call fsync(3), if the OS
supports it, to force the OS immediately to write the data
to permanent storage. This is optional for those who wish
to avoid excessive disk I/O.
.SS MIME (mime)
MIME-related options (handlers of various MIME types).
.SS File extension associations (mime.extension)
Extension <-> MIME type association.
.TP
\f3mime.extension._template_\f2 <str>\f1 (default: "")
MIME-type matching this file extension ('*' is used here in place
of '.').
.SS File type handlers (mime.handler)
A file type handler is a set of information about how to use
an external program to view a file. It is possible to refer to it
for several MIME types -- e.g., you can define an 'image' handler
to which mime.type.image.png, mime.type.image.jpeg, and so on will
refer; or one might define a handler for a more specific type of file
-- e.g., PDF files.
Note you must define both a MIME handler and a MIME type association
for it to work.
.SS Template option folder (mime.handler._template_)
Description of this handler.
.SS Template option folder (mime.handler._template_._template_)
System-specific handler description (ie. unix, unix-xwin, ...).
.TP
\f3mime.handler._template_._template_.ask\f2 [0|1]\f1 (default: 1)
Ask before opening.
.TP
\f3mime.handler._template_._template_.block\f2 [0|1]\f1 (default: 1)
Block the terminal when the handler is running.
.TP
\f3mime.handler._template_._template_.program\f2 <str>\f1 (default: "")
External viewer for this file type. '%' in this string will be
substituted by a file name.
.SS Mailcap (mime.mailcap)
Options for mailcap support.
.TP
\f3mime.mailcap.enable\f2 [0|1]\f1 (default: 1)
Enable mailcap support.
.TP
\f3mime.mailcap.path\f2 <str>\f1 (default: "~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap:/usr/share/mailcap:/usr/share/misc/mailcap")
Mailcap search path. Colon-separated list of files.
Leave as "" to use MAILCAP environment variable instead.
.TP
\f3mime.mailcap.ask\f2 [0|1]\f1 (default: 1)
Ask before using the handlers defined by mailcap.
.TP
\f3mime.mailcap.description\f2 <num>\f1 (default: 0)
Type of description to show in "what to do with this file"
query dialog:
.RS
.PD 0
.TP
.B 0
is show "mailcap"
.TP
.B 1
is show program to be run
.TP
.B 2
is show mailcap description field if any; "mailcap" otherwise
.PD
.RE
.TP
\f3mime.mailcap.prioritize\f2 [0|1]\f1 (default: 1)
Prioritize entries by the order of the files in the mailcap
path. This means that wildcard entries (like: image/*) will
also be checked before deciding the handler.
.SS Mimetypes files (mime.mimetypes)
Options for the support of mime.types files. These files
can be used to find the content type of an URL by looking at
the extension of the file name.
.TP
\f3mime.mimetypes.enable\f2 [0|1]\f1 (default: 1)
Enable mime.types support.
.TP
\f3mime.mimetypes.path\f2 <str>\f1 (default: "~/.mime.types:/etc/mime.types:/usr/etc/mime.types:/usr/local/etc/mime.types:/usr/share/mime.types:/usr/share/misc/mime.types")
The search path for mime.types files. Colon-separated list of files.
.SS MIME type associations (mime.type)
Handler <-> MIME type association. The first sub-tree is the MIME
class while the second sub-tree is the MIME type (ie. image/gif
handler will reside at mime.type.image.gif). Each MIME type option
should contain (case-sensitive) name of the MIME handler (its
properties are stored at mime.handler.<name>).
.SS Template option folder (mime.type._template_)
Handler matching this MIME-type class ('*' is used here in place
of '.').
.TP
\f3mime.type._template_._template_\f2 <str>\f1 (default: "")
Handler matching this MIME-type name ('*' is used here in place
of '.').
.TP
\f3mime.default_type\f2 <str>\f1 (default: "application/octet-stream")
Document MIME-type to assume by default (when we are unable to
guess it properly from known information about the document).
.SS Protocols (protocol)
Protocol specific options.
.SS Local files (protocol.file)
Options specific to local browsing.
.SS Local CGI (protocol.file.cgi)
Local CGI specific options.
.TP
\f3protocol.file.cgi.path\f2 <str>\f1 (default: "")
Colon separated list of directories, where CGI scripts are stored.
.TP
\f3protocol.file.cgi.policy\f2 [0|1]\f1 (default: 0)
Whether to execute local CGI scripts.
.TP
\f3protocol.file.allow_special_files\f2 [0|1]\f1 (default: 0)
Whether to allow reading from non-regular files.
Note this can be dangerous; reading /dev/urandom or
/dev/zero can ruin your day!
.TP
\f3protocol.file.show_hidden_files\f2 [0|1]\f1 (default: 1)
When set to false, files with name starting with a dot will be
hidden in local directories listing.
.TP
\f3protocol.file.try_encoding_extensions\f2 [0|1]\f1 (default: 1)
When set, if we can't open a file named 'filename', we'll try
to open 'filename' with some encoding extension appended
(ie. 'filename.gz'); it depends on the supported encodings.
.SS FTP (protocol.ftp)
FTP specific options.
.SS Proxy configuration (protocol.ftp.proxy)
FTP proxy configuration.
.TP
\f3protocol.ftp.proxy.host\f2 <str>\f1 (default: "")
Host and port-number (host:port) of the FTP proxy, or blank.
If it's blank, FTP_PROXY environment variable is checked as well.
.TP
\f3protocol.ftp.anon_passwd\f2 <str>\f1 (default: "[e-mail]")
FTP anonymous password to be sent.
.TP
\f3protocol.ftp.use_pasv\f2 [0|1]\f1 (default: 1)
Use PASV instead of PORT (passive vs active mode, IPv4 only).
.TP
\f3protocol.ftp.use_epsv\f2 [0|1]\f1 (default: 0)
Use EPSV instead of EPRT (passive vs active mode, IPv6 only).
.SS HTTP (protocol.http)
HTTP-specific options.
.SS Server bug workarounds (protocol.http.bugs)
Server-side HTTP bugs workarounds.
.TP
\f3protocol.http.bugs.accept_charset\f2 [0|1]\f1 (default: 1)
The Accept-Charset header is quite long and sending it can trigger
bugs in some rarely found servers.
.TP
\f3protocol.http.bugs.allow_blacklist\f2 [0|1]\f1 (default: 1)
Allow blacklisting of buggy servers.
.TP
\f3protocol.http.bugs.broken_302_redirect\f2 [0|1]\f1 (default: 1)
Broken 302 redirect (violates RFC but compatible with Netscape).
This is a problem for a lot of web discussion boards and the like.
If they will do strange things to you, try to play with this.
.TP
\f3protocol.http.bugs.post_no_keepalive\f2 [0|1]\f1 (default: 0)
Disable keepalive connection after POST request.
.TP
\f3protocol.http.bugs.http10\f2 [0|1]\f1 (default: 0)
Use HTTP/1.0 protocol instead of HTTP/1.1.
.SS Proxy configuration (protocol.http.proxy)
HTTP proxy configuration.
.TP
\f3protocol.http.proxy.host\f2 <str>\f1 (default: "")
Host and port-number (host:port) of the HTTP proxy, or blank.
If it's blank, HTTP_PROXY environment variable is checked as well.
.TP
\f3protocol.http.proxy.user\f2 <str>\f1 (default: "")
Proxy authentication username.
.TP
\f3protocol.http.proxy.passwd\f2 <str>\f1 (default: "")
Proxy authentication password.
.SS Referer sending (protocol.http.referer)
HTTP referer sending options. HTTP referer is a special header
sent in the HTTP requests, which is supposed to contain the previous
page visited by the browser. This way, the server can know what link
did you follow when accessing that page. However, this behaviour
can unfortunately considerably affect privacy and can lead even to a
security problem on some badly designed web pages.
.TP
\f3protocol.http.referer.policy\f2 <num>\f1 (default: 3)
Mode of sending HTTP referer:
.RS
.PD 0
.TP
.B 0
is send no referer
.TP
.B 1
is send current URL as referer
.TP
.B 2
is send fixed fake referer
.TP
.B 3
is send previous URL as referer (correct, but insecure)
.PD
.RE
.TP
\f3protocol.http.referer.fake\f2 <str>\f1 (default: "")
Fake referer to be sent when policy is 2.
.TP
\f3protocol.http.accept_language\f2 <str>\f1 (default: "")
Send Accept-Language header.
.TP
\f3protocol.http.accept_ui_language\f2 [0|1]\f1 (default: 1)
Request localised versions of documents from web-servers (using the
Accept-Language header) using the language you have configured for
ELinks' user-interface (this also affects navigator.language ECMAScript
value available to scripts). Note that some see this as a potential
security risk because it tells web-masters and the FBI sniffers about
your language preference.
.TP
\f3protocol.http.trace\f2 [0|1]\f1 (default: 0)
If active, all HTTP requests are sent with TRACE as their method
rather than GET or POST. This is useful for debugging of both ELinks
and various server-side scripts --- the server only returns the client's
request back to the client verbatim. Note that this type of request may
not be enabled on all servers.
.TP
\f3protocol.http.user_agent\f2 <str>\f1 (default: "ELinks/%v (textmode; %s; %t-%b)")
Change the User Agent ID. That means identification string, which
is sent to HTTP server when a document is requested. The 'textmode'
token in the first field is our silent attempt to establish this as
a standard for new textmode user agents, so that the webmasters can
have just a single uniform test for these if they are ie. pushing
some lite version to them automagically.
%v in the string means ELinks version
%s in the string means system identification
%t in the string means size of the terminal
%b in the string means number of bars displayed by ELinks
Use " " if you don't want any User-Agent header to be sent at all.
.SS HTTPS (protocol.https)
HTTPS-specific options.
.SS Proxy configuration (protocol.https.proxy)
HTTPS proxy configuration.
.TP
\f3protocol.https.proxy.host\f2 <str>\f1 (default: "")
Host and port-number (host:port) of the HTTPS CONNECT proxy, or blank.
If it's blank, HTTPS_PROXY environment variable is checked as well.
.SS NNTP (protocol.nntp)
NNTP and news specific options.
.TP
\f3protocol.nntp.server\f2 <str>\f1 (default: "")
Used when resolving news: URIs. If set to the empty string
the value of the NNTPSERVER environment variable will be used.
.TP
\f3protocol.nntp.header_entries\f2 <str>\f1 (default: "Subject,From,Date,Message-ID,Newsgroups")
Comma separated list of which entries in the article header