man1/lariza.usage.1

   1 .TH lariza 1 "2021-01-03" "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 + \fBq\fP
  16 Close the current window. Quits the entire program if this was the last
  17 window and if there are no more active downloads (download manager is
  18 shown otherwise).
  19 .TP
  20 \fBMod1\fP + \fBw\fP
  21 Go to your \(lqhomepage\(rq. See the environment variable
  22 $\fBLARIZA_HOME_URI\fP.
  23 .TP
  24 \fBMod1\fP + \fBe\fP
  25 Open a new window.
  26 .TP
  27 \fBMod1\fP + \fBr\fP
  28 Reload the current page.
  29 .TP
  30 \fBMod1\fP + \fBd\fP
  31 Open the download manager.
  32 .TP
  33 \fBMod1\fP + \fBl\fP
  34 Focus the location bar.
  35 .TP
  36 \fBMod1\fP + \fBk\fP
  37 Focus the location bar and set its text to \fB:/\fP, allowing you to
  38 easily initiate a search.
  39 .TP
  40 \fBMod1\fP + \fB2\fP
  41 .TQ
  42 \fBMod1\fP + \fBn\fP
  43 Repeat the last search (forward).
  44 .TP
  45 \fBMod1\fP + \fB3\fP
  46 Repeat the last search (backward).
  47 .TP
  48 \fBMod1\fP + \fBc\fP
  49 Reload trusted certificates.
  50 .TP
  51 \fBMod1\fP + \fBa\fP / \fBMod1\fP + \fBs\fP
  52 Select tab to the left / right.
  53 .TP
  54 \fBF2\fP / \fBF3\fP
  55 Go backward and forward in current browser history.
  56 .P
  57 .SS "Main window \(em WebKit viewport focused"
  58 .TP
  59 \fBEscape\fP
  60 Stop loading.
  61 .TP
  62 \fBMiddle mouse\fP
  63 Open the link under the pointer in a new window.
  64 .TP
  65 \fBBackward\fP / \fBforward\fP (mouse keys 8 and 9)
  66 Same as \fBF2\fP and \fBF3\fP.
  67 .TP
  68 \fBMod1\fP + \fBScroll up\fP
  69 .TQ
  70 \fBCtrl\fP + \fBScroll up\fP
  71 Increase zoom level of the current page.
  72 .TP
  73 \fBMod1\fP + \fBScroll down\fP
  74 .TQ
  75 \fBCtrl\fP + \fBScroll down\fP
  76 Decrase zoom level of the current page.
  77 .TP
  78 \fBMod1\fP + \fBScroll horizontally\fP
  79 .TQ
  80 \fBCtrl\fP + \fBScroll horizontally\fP
  81 Reset zoom to $\fBLARIZA_ZOOM\fP.
  82 .P
  83 .SS "Main window \(em location bar focused"
  84 .TP
  85 \fBEscape\fP
  86 Reset the content of the location bar to the current URI.
  87 .TP
  88 \fBReturn\fP
  89 Commit, i.e. begin searching or open the URI.
  90 .P
  91 .SS "Download manager"
  92 .TP
  93 \fBMod1\fP + \fBd\fP
  94 .TQ
  95 \fBMod1\fP + \fBq\fP
  96 Close the download manager. Active downloads are never aborted. However,
  97 if there are no more active downloads and no more browsing windows, then
  98 the entire program will quit.
  99 .\" --------------------------------------------------------------------
 100 .SH "DOWNLOAD MANAGER"
 101 Open the download manager using the appropriate hotkey. A new window
 102 listing your downloads will appear. Clicking on an item will remove it
 103 from the list and \(em if needed \(em cancel the download.
 104 .P
 105 There's no file manager integration, nor does \fBlariza\fP delete,
 106 overwrite or resume downloads. If a file already exists, it won't be
 107 touched. Instead, the new file name will have a suffix such as \fB.1\fP,
 108 \fB.2\fP, \fB.3\fP, and so on.
 109 .\" --------------------------------------------------------------------
 110 .SH "USER-SUPPLIED JAVASCRIPT FILES"
 111 After a page has been successfully loaded, the directory
 112 \fI~/.config\:/lariza\:/user-scripts\fP will be scanned and each file in
 113 it ending with \fB.js\fP will be run as a JavaScript file in the context
 114 of said page.
 115 .P
 116 During development, you will most likely want to run \fBlariza\fP with
 117 $\fBLARIZA_ENABLE_CONSOLE_TO_STDOUT\fP enabled.
 118 .P
 119 \fBlariza\fP comes with the following scripts:
 120 .TP
 121 \fBhints.js\fP
 122 Press \fBf\fP (open link in current window) or \fBF\fP (open in new
 123 window) to activate link hints. After typing the characters for one of
 124 them, press \fBEnter\fP to confirm. Press \fBEscape\fP to abort.
 125 .P
 126 Those bundled scripts are automatically installed on \fBmake install\fP.
 127 To use them, though, make sure to link them to the directory mentioned
 128 above.
 129 .\" --------------------------------------------------------------------
 130 .SH "WEB EXTENSIONS"
 131 On startup, WebKit checks \fI~/.config/lariza/web_extensions\fP for any
 132 \fB.so\fP files. See
 133 .UR http://\:blogs.igalia.com/\:carlosgc/\:2013/\:09/\:10/\:webkit2gtk-\:web-\:process-\:extensions/
 134 this blog post
 135 .UE
 136 for further information on these extensions.
 137 .P
 138 \fBlariza\fP comes with the following extensions:
 139 .TP
 140 \fBwe_adblock.so\fP
 141 Generic adblock. Reads patterns from the file
 142 \fI~/.config/lariza/adblock\fP. Each line can contain a regular
 143 expression. These expressions match case-insensitive and partially, i.e.
 144 \fB.*foo.*\fP is the same as \fB.*FOO.*\fP and you can use anchors like
 145 \fB^https?://...\fP. Please refer to
 146 .UR https://\:developer.\:gnome.\:org/\:glib/\:stable/\:glib-\:regex-\:syntax.html
 147 the GLib reference
 148 .UE
 149 for more details. Lines starting with \fB#\fP are ignored.
 150 .P
 151 Those bundled web extensions are automatically compiled when you run
 152 \fBmake\fP and installed on \fBmake install\fP. To use them, though,
 153 make sure to link them to the directory mentioned above.
 154 .\" --------------------------------------------------------------------
 155 .SH "TRUSTED CERTIFICATES"
 156 By default, \fBlariza\fP trusts whatever CAs are trusted by WebKit. If
 157 you wish to trust additional certificates, such as self-signed
 158 certificates, the first thing you should do is try to add the
 159 appropriate CAs to your system-wide store.
 160 .P
 161 If you wish to add simple exceptions, you can grab the certificate and
 162 store it in the directory \fI~/.config/lariza/certs\fP. The filename
 163 must be equal to the hostname:
 164 .P
 165 \f(CW
 166 .nf
 167 \&$ echo | openssl s_client -connect foo.de:443 | openssl x509 >foo.de
 168 .fi
 169 \fP
 170 .P
 171 This tells \fBlariza\fP to trust the given certificate when connecting
 172 to host \fBfoo.de\fP.
 173 .P
 174 You can reload these certificates at runtime by pressing the appropriate
 175 hotkey. Note that removed certificates will be kept in memory until you
 176 restart \fBlariza\fP.
 177 .P
 178 Note: This is NOT equal to certificate pinning. WebKit ignores
 179 user-specified certificates if the server's certificate can be validated
 180 by any system-wide CA.
 181 .\" --------------------------------------------------------------------
 182 .SH "SEE ALSO"
 183 .BR lariza (1).