chorizo-usage.1

   1 .Dd $Mdocdate$
   2 .Dt CHORIZO 1
   3 .Os
   4 .
   5 .Sh NAME
   6 .Nm chorizo-usage
   7 .Nd extended usage hints
   8 .
   9 .Sh UI ELEMENTS
  10 .Ss DOWNLOAD MANAGER
  11 The download manager lets you view in-progress and completed downloads.
  12 Launch it with ^y. To manage downloads, just click on them.
  13 .
  14 .Ss THE TAB STACK
  15 Tabs are presented vertically on the left side of the window.
  16 Tabs can be dragged to be reordered,
  17 and middle clicked to close.
  18 Muted tabs are given the "[M]" prefix.
  19 .
  20 .Ss THE URL AND SEARCH BARS
  21 At the bottom of the screen are the URL and the search bars.
  22 Focus the URL bar with ^s, and the search bar with ^d.
  23 .
  24 .Ss THE ISEARCH BAR
  25 Hit ^f to open up the isearch bar.
  26 This lets you search for text within the page.
  27 Enter and shift-enter will cycle through matches.
  28 Escape or ^g will close it.
  29 .
  30 .Sh USER CONTENT
  31 .Ss JAVASCRIPT
  32 When a new web process is launched,
  33 .Pa ~/.local/share/chorizo/user-scripts
  34 is scanned for files with the .js suffix.
  35 These scripts will be run every time a page is loaded.
  36 .Pp
  37 The chorizo repository contains the following optional scripts:
  38 .Bl -tag
  39 .It mouseover.js
  40 Shows password when hovering over field.
  41 .It hints.js
  42 Provides link hints.
  43 Press "f" to activate link hints for opening in the current tab,
  44 or "F" for a new tab.
  45 After entering the according code,
  46 press enter to confirm or escape to abort.
  47 .It privacy-redirect.js
  48 Redirects social media sites to privacy respecting alternatives.
  49 .It darkreader.js
  50 Makes webpages dark.
  51 .El
  52 .Pp
  53 These scripts are installed by default to
  54 .Pa /usr/local/share/chorizo/user-scripts
  55 .
  56 .Ss CSS
  57 When a new web process is launched,
  58 .Pa ~/.local/share/chorizo/user-styles
  59 is scanned for files with the .css suffix.
  60 These styles will be applied  every time a page is loaded.
  61 .
  62 .Ss WEB EXTENSIONS
  63 When a new web process is launched,
  64 .Pa ~/.local/share/chorizo/web-extensions
  65 for webkit2gtk web extensions.
  66 See
  67 http://blog.igalia.com/carlosgc/2013/09/10/webkit2gtk-web-process-extensions/
  68 for more informatino.
  69 .Pp
  70 NB: these are different than Firefox/Chromium WebExtensions.
  71 .Pp
  72 The chorizo repository contains the following optional web extensions:
  73 .Bl -tag
  74 .It we_adblock.so
  75 Generic adblocker.
  76 Reads patterns from
  77 .Pa ~/.config/chorizo/adblock
  78 Each line can contain a regular expression.
  79 These expressions match case insesitively,
  80 and anchors like ^https?://.... can be used.
  81 .Pp
  82 Eg:
  83 *foo.* is the same as .*FOO.*
  84 .Pp
  85 See
  86 https://developer.gnome.org/glib/stable/glib-regex-syntax.html
  87 for more information.
  88 Lines starting with "#" are ignored.
  89 .El
  90 .Pp
  91 These web extensions are installed by default to
  92 .Pa /usr/local/share/chorizo/web-extensions
  93 .
  94 .Sh TRUSTED CERTIFICATES
  95 By default,
  96 .Nm
  97 trusts whatever CAs are trusted by Webkit.
  98 If you wish to trust additional certificates,
  99 and you cannot add it to the system-wide store,
 100 then you can store the certificate in
 101 .Pa ~/.local/share/chorizo/certs/
 102 The filename must be the same as the hostname.
 103 .Pp
 104 NB: This is NOT equal to certificate pinning.
 105 WebKit ignores user-specified certificates if the server's certificate can be
 106 validated by any system-wide CA.
 107 .
 108 .Sh SEE ALSO
 109 .Xr chorizo 1