.Dd $Mdocdate$
.Dt CHORIZO 1
.Os
.
.Sh NAME
.Nm chorizo-usage
.Nd extended usage hints
.
.Sh UI ELEMENTS
.Ss DOWNLOAD MANAGER
The download manager lets you view in-progress and completed downloads.
Launch it with ^y. To manage downloads, just click on them.
.
.Ss THE TAB STACK
Tabs are presented vertically on the left side of the window.
Tabs can be dragged to be reordered,
and middle clicked to close.
Muted tabs are given the "[M]" prefix.
.
.Ss THE URL AND SEARCH BARS
At the bottom of the screen are the URL and the search bars.
Focus the URL bar with ^s, and the search bar with ^d.
.
.Ss THE ISEARCH BAR
Hit ^f to open up the isearch bar.
This lets you search for text within the page.
Enter and shift-enter will cycle through matches.
Escape or ^g will close it.
.
.Sh USER CONTENT
.Ss JAVASCRIPT
When a new web process is launched,
.Pa ~/.local/share/chorizo/user-scripts
is scanned for files with the .js suffix.
These scripts will be run every time a page is loaded.
.Pp
The chorizo repository contains the following optional scripts:
.Bl -tag
.It mouseover.js
Shows password when hovering over field.
.It hints.js
Provides link hints.
Press "f" to activate link hints for opening in the current tab,
or "F" for a new tab.
After entering the according code,
press enter to confirm or escape to abort.
.It privacy-redirect.js
Redirects social media sites to privacy respecting alternatives.
.It darkreader.js
Makes webpages dark.
.El
.Pp
These scripts are installed by default to
.Pa /usr/local/share/chorizo/user-scripts
.
.Ss CSS
When a new web process is launched,
.Pa ~/.local/share/chorizo/user-styles
is scanned for files with the .css suffix.
These styles will be applied  every time a page is loaded.
.
.Ss WEB EXTENSIONS
When a new web process is launched,
.Pa ~/.local/share/chorizo/web-extensions
for webkit2gtk web extensions.
See
http://blog.igalia.com/carlosgc/2013/09/10/webkit2gtk-web-process-extensions/
for more informatino.
.Pp
NB: these are different than Firefox/Chromium WebExtensions.
.Pp
The chorizo repository contains the following optional web extensions:
.Bl -tag
.It we_adblock.so
Generic adblocker.
Reads patterns from
.Pa ~/.config/chorizo/adblock
Each line can contain a regular expression.
These expressions match case insesitively,
and anchors like ^https?://.... can be used.
.Pp
Eg:
*foo.* is the same as .*FOO.*
.Pp
See
https://developer.gnome.org/glib/stable/glib-regex-syntax.html
for more information.
Lines starting with "#" are ignored.
.El
.Pp
These web extensions are installed by default to
.Pa /usr/local/share/chorizo/web-extensions
.
.Sh TRUSTED CERTIFICATES
By default,
.Nm
trusts whatever CAs are trusted by Webkit.
If you wish to trust additional certificates,
and you cannot add it to the system-wide store,
then you can store the certificate in
.Pa ~/.local/share/chorizo/certs/
The filename must be the same as the hostname.
.Pp
NB: This is NOT equal to certificate pinning.
WebKit ignores user-specified certificates if the server's certificate can be
validated by any system-wide CA.
.
.Sh SEE ALSO
.Xr chorizo 1