vimprobablerc.5

   1 .\" Process this file with
   2 .\" groff -man -Tascii vimprobablerc.5
   3 .\"
   4 .TH VIMPROBABLERC 5 "FEBRUARY 2012" "Linux User Manuals"
   5 .SH NAME
   6 vimprobablerc \- The configuration file for Vimprobable
   7 .SH DESCRIPTION
   8 If you have a .config/vimprobable/vimprobablerc in your home directory, Vimprobable
   9 will read it at startup.
  10 .PP
  11 The vimprobablerc file consists of a series of configuration options, one per line. Blank lines and lines starting with a
  12 colon (:) are seen as comments and will be ignored.
  13 .SH FILES
  14 .I $HOME/.config/vimprobable/vimprobablerc
  15 .PP
  16 Per user configuration file.
  17 .SH FORMAT
  18 .IP set
  19 .RS
  20 set is used to alter a default setting. For possible options that can be altered,
  21 see the SETTINGS section below.
  22
  23 Each line looks like this:
  24
  25 .I "    " set what=value
  26
  27 Vimprobable is not picky about white space in these lines.
  28 .RE
  29 .IP map
  30 .RS
  31 map is used to change the default key-binding. For possible options that
  32 can be altered see the MAPPING section below.
  33
  34 Each line looks like this:
  35
  36 .I "    " map what=value
  37
  38 Vimprobable is not picky about white space in these lines.
  39
  40 .RE
  41 .IP misc
  42 .RS
  43 Any command listed under colon commands in vimprobable2(1) will be accepted in the config file as well.
  44
  45
  46 .SH FORMAT MODIFIED KEYS
  47
  48 It is possible to map keys modified with eiter Control or Modkeys.
  49 To map a key modified with Control, use this format: <C-h>
  50 where C stands for the Control-key and h for the h-key.
  51 <M1-j> maps the combination of Mod1 and the j-key. Mod1 is
  52 usually the "Alt" key, Mod4 the "Windows" key.
  53
  54 Examples:
  55 <C-h> : Ctrl-h
  56 <C-k> : Ctrl-k
  57 z<M1-i>: z followed by Alt-i
  58
  59 .RE
  60
  61 .SH SETTINGS
  62
  63 This section describes the possible options that can be changed from
  64 their default value.
  65
  66 .IP completioncase=[true|false]
  67 Case sensitive (true) or insensitive tab completion.
  68
  69 .IP homepage=URL
  70 Set the URL of the homepage.
  71
  72 .IP useragent=<useragent-string>
  73 Replace the default useragent-string.
  74
  75 .IP acceptlanguage=<acceptlanguage-string>
  76 Replace the default acceptlanguage-string.
  77
  78 .IP scripts=[true|false]
  79 Enable or disable scripts.
  80
  81 .IP plugins=[true|false]
  82 Enable or disable plugins.
  83
  84 .IP java=[true|false]
  85 Enable or disable Java applets.
  86
  87 .IP images=[true|false]
  88 Enable or disable autoload of images.
  89
  90 .IP shrinkimages=[true|false]
  91 Enable or disable autoshrink of images.
  92
  93 .IP cursivefont=cursivefont-family
  94 Replace the default cursive font family
  95
  96 .IP defaultencoding=encoding
  97 Replace the default encoding
  98
  99 .IP defaultfont=default-font-family
 100 Replace the default font family
 101
 102 .IP defaultsearch=searchengine-shortcut
 103 Replace the default search engine
 104
 105 .IP escapeinput=[true|false]
 106 Ignore automatic focusing of input elements by websites on load.
 107
 108 .IP fontsize=integer
 109 Replace the default fontsize
 110
 111 .IP monofontsize=integer
 112 Replace the default monospace fontsize
 113
 114 .IP caret=[true|false]
 115 Enable or disable caret browsing
 116
 117 .IP fantasyfont=fantasy-font-family
 118 Replace the default fantasy font family
 119
 120 .IP minimumfontsize=integer
 121 Replace the default minimum font size
 122
 123 .IP monofont=default-monospace-font-family
 124 Replace the default monospace font family
 125
 126 .IP pagecache=[true|false]
 127 Enable or disable webkit's internal page cache
 128
 129 .IP proxy=[true|false]
 130 Whether to read and use the http_proxy environment variable
 131
 132 .IP backgrounds=[true|false]
 133 Enable or disable print backgrounds
 134
 135 .IP sansfont=default-sans-font-family
 136 Replace the default sans-serif font family
 137
 138 .IP scrollbars=[true|false]
 139 Enable or disable scrollbars.
 140
 141 .IP statusbar=[true|false]
 142 Show or hide the status bar.
 143
 144 .IP inputbox=[true|false]
 145 Show or hide the input box.
 146
 147 .IP seriffont=default-serif-font-family
 148 Replace the default serif font family
 149
 150 .IP stylesheet=URL
 151 Replace the user stylesheet
 152
 153 .IP webinspector=[true|false]
 154 Enable or disable webinspector
 155
 156 .IP strictssl=[true|false]
 157 Reject or accept unverified certificates (default: true)
 158
 159 .IP cabundle=/path/to/file
 160 Where CA certificates are stored (default: /etc/ssl/certs/ca-certificates.crt)
 161
 162 .SH MAPPINGS
 163
 164 Keys can be mapped to the following functions:
 165
 166 .IP quit
 167 Close the browser
 168
 169 .IP stop
 170 Stop the current loading process
 171
 172 .IP bookmark
 173 Save the current website in the bookmarks
 174
 175 .IP source
 176 Toggle HTML source view
 177
 178 .IP jumpleft
 179 Scroll to left edge
 180
 181 .IP jumpright
 182 Scroll to right edge
 183
 184 .IP jumptop
 185 Scroll to top of the page
 186
 187 .IP jumpbottom
 188 Scroll to bottom of the page
 189
 190 .IP pageup
 191 Scroll one screensize up
 192
 193 .IP pagedown
 194 Scroll one screensize down
 195
 196 .IP navigationback
 197 Go to previous page in browser-history
 198
 199 .IP navigationforward
 200 Go to next page in browser-history
 201
 202 .IP reload
 203 Reload current page
 204
 205 .IP scrollleft
 206 Scroll the page one step to the left
 207
 208 .IP scrollright
 209 Scroll the page one step to the right
 210
 211 .IP scrollup
 212 Scroll the page one step up
 213
 214 .IP scrolldown
 215 Scroll the page one step down
 216
 217 Example:
 218 To map the 'R' key to reload to current page, add the following
 219 line into ~/.config/vimprobable/vimprobablerc:
 220
 221 map R reload
 222
 223 .SH MAPPING COLON COMMANDS
 224
 225 Key can be mapped to any colon commands. Instead of entering an
 226 internal symbol for the key combination to be mapped to, enter
 227 a command line as you would enter it within a running browser
 228 instance. For example:
 229
 230 map <C-s>=:set scripts=false
 231
 232 This would map Control-s to disable Javascript.
 233
 234 map i=:javascript console.log('insertmode_on')
 235
 236 This maps the i key to manually activate INSERT mode.
 237
 238 .SH INTERACTIVE SETTING
 239 All settings can be changed on the fly by entering
 240 :set followed by one of the commands in the SETTINGS section
 241 above.
 242
 243 .SH SEARCH ENGINES
 244
 245 You can define new search engine shortcuts or override the pre-defined ones
 246 using the following format (without the angle brackets):
 247
 248 .RS 4
 249 searchengine <shortcut> <URL with exactly one %s>
 250 .RE
 251
 252 where the %s serves as a placeholder for the search term. Other percent signs
 253 in the URL have to be escaped as %%\&.
 254
 255 .SH URI HANDLERS
 256
 257 You can define external applications to handle requests for defined URI schemas
 258 using the following syntax (without the angle brackets):
 259
 260 .RS 4
 261 handler <URI schema> <handler command with exactly one %s>
 262 .RE
 263
 264 where the %s serves as a placeholder for the rest of the URI.
 265
 266 .SH BUGS
 267 There has not been any significant bug-hunting yet.
 268 .SH AUTHORS
 269 Hannes Schueller and Matto Fransen
 270 .SH "SEE ALSO"
 271 .BR vimprobable2 (1),