man1/lariza.usage.1

   1 .TH lariza 1 "2020-04-28" "lariza" "User Commands"
   2 .\" --------------------------------------------------------------------
   3 .SH NAME
   4 lariza.usage \- extended usage hints
   5 .\" --------------------------------------------------------------------
   6 .SH DESCRIPTION
   7 \fBlariza\fP is a simple web browser using GTK+ 3, GLib and WebKit2GTK+.
   8 This manpage contains additional hints and pointers regarding its usage.
   9 .\" --------------------------------------------------------------------
  10 .SH "HOTKEYS"
  11 .SS "Global hotkeys"
  12 These hotkeys work when either the location bar or the web view is being
  13 focused.
  14 .TP
  15 \fBMod1\fP + \fBx\fP
  16 Launch the external handler for the currently loaded URI.
  17 .TP
  18 \fBMod1\fP + \fBq\fP
  19 Close the current window. Quits the entire program if this was the last
  20 window and if there are no more active downloads (download manager is
  21 shown otherwise).
  22 .TP
  23 \fBMod1\fP + \fBw\fP
  24 Go to your \(lqhomepage\(rq. See the environment variable
  25 $\fBLARIZA_HOME_URI\fP.
  26 .TP
  27 \fBMod1\fP + \fBe\fP
  28 Open a new window.
  29 .TP
  30 \fBMod1\fP + \fBr\fP
  31 Reload the current page.
  32 .TP
  33 \fBMod1\fP + \fBd\fP
  34 Open the download manager.
  35 .TP
  36 \fBMod1\fP + \fBl\fP
  37 Focus the location bar.
  38 .TP
  39 \fBMod1\fP + \fBk\fP
  40 Focus the location bar and set its text to \fB:/\fP, allowing you to
  41 easily initiate a search.
  42 .TP
  43 \fBMod1\fP + \fB2\fP
  44 .TQ
  45 \fBMod1\fP + \fBn\fP
  46 Repeat the last search (forward).
  47 .TP
  48 \fBMod1\fP + \fB3\fP
  49 Repeat the last search (backward).
  50 .TP
  51 \fBMod1\fP + \fBc\fP
  52 Reload trusted certificates.
  53 .TP
  54 \fBMod1\fP + \fBa\fP / \fBMod1\fP + \fBs\fP
  55 Select tab to the left / right.
  56 .TP
  57 \fBF2\fP / \fBF3\fP
  58 Go backward and forward in current browser history.
  59 .P
  60 .SS "Main window \(em WebKit viewport focused"
  61 .TP
  62 \fBEscape\fP
  63 Stop loading.
  64 .TP
  65 \fBMiddle mouse\fP
  66 Open the link under the pointer in a new window.
  67 .TP
  68 \fBBackward\fP / \fBforward\fP (mouse keys 8 and 9)
  69 Same as \fBF2\fP and \fBF3\fP.
  70 .TP
  71 \fBMod1\fP + \fBScroll up\fP
  72 .TQ
  73 \fBCtrl\fP + \fBScroll up\fP
  74 Increase zoom level of the current page.
  75 .TP
  76 \fBMod1\fP + \fBScroll down\fP
  77 .TQ
  78 \fBCtrl\fP + \fBScroll down\fP
  79 Decrase zoom level of the current page.
  80 .TP
  81 \fBMod1\fP + \fBScroll horizontally\fP
  82 .TQ
  83 \fBCtrl\fP + \fBScroll horizontally\fP
  84 Reset zoom to $\fBLARIZA_ZOOM\fP.
  85 .P
  86 .SS "Main window \(em location bar focused"
  87 .TP
  88 \fBEscape\fP
  89 Reset the content of the location bar to the current URI.
  90 .TP
  91 \fBReturn\fP
  92 Commit, i.e. begin searching or open the URI.
  93 .P
  94 .SS "Download manager"
  95 .TP
  96 \fBMod1\fP + \fBd\fP
  97 .TQ
  98 \fBMod1\fP + \fBq\fP
  99 Close the download manager. Active downloads are never aborted. However,
 100 if there are no more active downloads and no more browsing windows, then
 101 the entire program will quit.
 102 .\" --------------------------------------------------------------------
 103 .SH "DOWNLOAD MANAGER"
 104 Open the download manager using the appropriate hotkey. A new window
 105 listing your downloads will appear. Clicking on an item will remove it
 106 from the list and \(em if needed \(em cancel the download.
 107 .P
 108 There's no file manager integration, nor does \fBlariza\fP delete,
 109 overwrite or resume downloads. If a file already exists, it won't be
 110 touched. Instead, the new file name will have a suffix such as \fB.1\fP,
 111 \fB.2\fP, \fB.3\fP, and so on.
 112 .\" --------------------------------------------------------------------
 113 .SH "USER-SUPPLIED JAVASCRIPT FILES"
 114 After a page has been successfully loaded, the directory
 115 \fI~/.config\:/lariza\:/user-scripts\fP will be scanned and each file in
 116 it ending with \fB.js\fP will be run as a JavaScript file in the context
 117 of said page.
 118 .P
 119 During development, you will most likely want to run \fBlariza\fP with
 120 $\fBLARIZA_ENABLE_CONSOLE_TO_STDOUT\fP enabled.
 121 .P
 122 \fBlariza\fP comes with the following scripts:
 123 .TP
 124 \fBhints.js\fP
 125 Press \fBf\fP (open link in current window) or \fBF\fP (open in new
 126 window) to activate link hints. After typing the characters for one of
 127 them, press \fBEnter\fP to confirm. Press \fBEscape\fP to abort.
 128 .P
 129 Those bundled scripts are automatically installed on \fBmake install\fP.
 130 To use them, though, make sure to link them to the directory mentioned
 131 above.
 132 .\" --------------------------------------------------------------------
 133 .SH "WEB EXTENSIONS"
 134 On startup, WebKit checks \fI~/.config/lariza/web_extensions\fP for any
 135 \fB.so\fP files. See
 136 .UR http://\:blogs.igalia.com/\:carlosgc/\:2013/\:09/\:10/\:webkit2gtk-\:web-\:process-\:extensions/
 137 this blog post
 138 .UE
 139 for further information on these extensions.
 140 .P
 141 \fBlariza\fP comes with the following extensions:
 142 .TP
 143 \fBwe_adblock.so\fP
 144 Generic adblock. Reads patterns from the file
 145 \fI~/.config/lariza/adblock.black\fP. Each line can contain a regular
 146 expression. These expressions match case-insensitive and partially, i.e.
 147 \fB.*foo.*\fP is the same as \fB.*FOO.*\fP and you can use anchors like
 148 \fB^https?://...\fP. Please refer to
 149 .UR https://\:developer.\:gnome.\:org/\:glib/\:stable/\:glib-\:regex-\:syntax.html
 150 the GLib reference
 151 .UE
 152 for more details. Lines starting with \fB#\fP are ignored.
 153 .P
 154 Those bundled web extensions are automatically compiled when you run
 155 \fBmake\fP and installed on \fBmake install\fP. To use them, though,
 156 make sure to link them to the directory mentioned above.
 157 .\" --------------------------------------------------------------------
 158 .SH "EXTERNAL URI HANDLER"
 159 \fBlariza\fP can launch an executable called
 160 \fIlariza-external-handler\fP. It will be passed the \(lqselected\(rq
 161 URI as a command line argument:
 162 .P
 163 \f(CW
 164 .nf
 165 $ lariza-external-handler -u https://github.com
 166 .fi
 167 \fP
 168 .P
 169 This executable must be a user-supplied program. It can do anything it
 170 wants to with that URI. \fBlariza\fP ignores the exit code of the
 171 handler.
 172 .P
 173 The \fB\-u\fP will always be set. This allows you to use \fBgetopt\fP(1)
 174 like parameter parsing in your program.
 175 .P
 176 You can either use the appropriate hotkey (see list above) to launch the
 177 handler with the currently loaded URI, or you can perform a right click
 178 on any link, image or media file to use that URI.
 179 .P
 180 This mechanism allows you to implement a variety of functions. You might
 181 want to implement a bookmarking script or a password manager or you
 182 might simply load the current URI in a different browser. That's up to
 183 you.
 184 .\" --------------------------------------------------------------------
 185 .SH "TRUSTED CERTIFICATES"
 186 By default, \fBlariza\fP trusts whatever CAs are trusted by WebKit, i.e.
 187 by your GnuTLS installation. If you wish to trust additional
 188 certificates, such as self-signed certificates, the first thing you
 189 should do is try to add the appropriate CAs to your system-wide store.
 190 .P
 191 If you wish to add simple exceptions, you can grab the certificate and
 192 store it in the directory \fI~/.config/lariza/certs\fP. The filename
 193 must be equal to the hostname:
 194 .P
 195 \f(CW
 196 .nf
 197 \&$ echo | openssl s_client -connect foo.de:443 | openssl x509 >foo.de
 198 .fi
 199 \fP
 200 .P
 201 This tells \fBlariza\fP to trust the given certificate when connecting
 202 to host \fBfoo.de\fP.
 203 .P
 204 You can reload these certificates at runtime by pressing the appropriate
 205 hotkey. Note that removed certificates will be kept in memory until you
 206 restart \fBlariza\fP.
 207 .P
 208 Note: This is NOT equal to certificate pinning. WebKit ignores
 209 user-specified certificates if the server's certificate can be validated
 210 by any system-wide CA.
 211 .\" --------------------------------------------------------------------
 212 .SH "WEBKIT LOCAL STORAGE"
 213 WebKit does create files in your $\fBXDG_*\fP directories, i.e.
 214 \fI~/.local/share\fP or \fI~/.cache\fP. It's up to you what you want to
 215 do with this junk. I remove it regularly when no WebKit browser is
 216 running. Another option would be to change the $\fBXDG_*\fP variables.
 217 .P
 218 I have explicitly not turned off the local storage feature in WebKit
 219 because I don't know if this breaks web applications.
 220 .\" --------------------------------------------------------------------
 221 .SH "SEE ALSO"
 222 .BR lariza (1).