doc/elinks.conf.5.txt

   1 elinks.conf(5)
   2 ==============
   3 :Description:   ELinks configuration file
   4
   5 NAME
   6 ----
   7 elinks.conf - ELinks configuration file
   8
   9 SYNOPSIS
  10 --------
  11 [verse]
  12 set     <option> = <value>
  13 unset   <option>
  14 bind    "<keymap>" "<key>" = "<action>"
  15 include "<file>"
  16
  17 DESCRIPTION
  18 -----------
  19
  20 The `elinks.conf` file contains configuration information for ELinks.  It can
  21 be used to configure the behaviour of ELinks in a wide variety of ways:
  22 protocol behaviour, keybindings, colors used for rendering and for the user
  23 interface.
  24
  25 It is read at startup and saved only when requested. All options described in
  26 this document can be fully configured from within ELinks so no editing of
  27 elinks.conf is needed.
  28
  29 Note that MIME-related options used for specifying handlers of various MIME
  30 types are NOT described in this document. Documentation for these options can
  31 be found at the ELinks homepage. Keybindings can also be specified in
  32 elinks.conf.  This is described in man:elinkskeys[5].
  33
  34 SYNTAX
  35 ------
  36
  37 The syntax of the configuration file is very simple. The elinks.conf file is a
  38 free-form ASCII text file. The file may contain extra tabs and newlines for
  39 formatting purposes. Keywords in the file are case-sensitive. Comments may be
  40 placed anywhere within the file (except within quotes). Comments begin with
  41 the # character and end at the end of the line.
  42
  43 EXAMPLES
  44 --------
  45
  46 Some sample settings:
  47
  48         # Use asynchronous DNS resolver?
  49         set connection.async_dns = 1
  50         # horizontal text margin.
  51         set document.browse.margin_width = 3
  52         # Default document codepage.
  53         set document.codepage.assume = "ISO-8859-1"
  54         # User defined protocol handlers
  55         set protocol.user.mailto.unix = "mutt %h -s \"%s\""
  56
  57 OPTIONS
  58 -------
  59
  60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  61 ifdef::backend-docbook[]
  62 include1::{builddir}option-config.frag.xml[]
  63 endif::backend-docbook[]
  64 ifdef::backend-xhtml11[]
  65 include1::{builddir}option-config.frag.xhtml[]
  66 endif::backend-xhtml11[]
  67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  68
  69 // The OpenSSL license requires the following acknowledgements in all
  70 // advertising materials that mention features of OpenSSL.  The web
  71 // pages at http://elinks.cz/ might be thought of as advertising, and
  72 // the documentation of the connection.ssl.cert_verify option mentions
  73 // a feature of OpenSSL.  So include the acknowledgements in the HTML
  74 // web page that documents the options.
  75 ifdef::man-webpage[]
  76
  77 ACKNOWLEDGEMENTS
  78 ----------------
  79
  80 If ELinks was configured to use OpenSSL, then the following apply:
  81
  82 - This product includes software developed by the OpenSSL Project
  83   for use in the OpenSSL Toolkit. (http://www.openssl.org/)
  84
  85 - This product includes cryptographic software written by
  86   Eric Young (eay@cryptsoft.com)
  87
  88 endif::man-webpage[]
  89
  90 SEE ALSO
  91 --------
  92 man:elinks[1], man:elinkskeys[5]