\fI~/.local\:/share\:/lariza\:/web_extensions\fP
Sets the directory where WebKit will look for web extensions. See
\fBlariza.usage\fP(1).
+.P
+The executable \fIlariza-external-handler\fP must be located somewhere
+in your $\fBPATH\fP, if you want to make use of the external URI
+handler. See \fBlariza.usage\fP(1) for details.
.\" --------------------------------------------------------------------
.SH LICENSE
\fBlariza\fP is released as \(lqPIZZA-WARE\(rq. See the accompanying
.SH "HOTKEYS"
.SS "Main window \(em WebKit viewport focused"
.TP
+\fBMod1\fP + \fBx\fP
+Launch the external handler for the currently loaded URI.
+.TP
\fBMod1\fP + \fBq\fP
Close the current window.
.TP
.P
.SS "Main window \(em location bar focused"
.TP
+\fBMod1\fP + \fBx\fP
+Launch the external handler for the currently loaded URI.
+.TP
\fBMod1\fP + \fBq\fP
Close the current window.
.TP
user-specified certificates if the server's certificate can be validated
by any system-wide CA.
.\" --------------------------------------------------------------------
+.SH "EXTERNAL URI HANDLER"
+\fBlariza\fP can launch an executable called
+\fIlariza-external-handler\fP. It will be passed the \(lqselected\(rq
+URI as a command line argument:
+.P
+.\f(CW
+.nf
+$ lariza-external-handler -u https://github.com
+.fi
+\fP
+.P
+This executable must be a user-supplied program. It can do anything it
+wants to with that URI. \fBlariza\fP ignores the exit code of the
+handler.
+.P
+The \fB\-u\fP will always be set. This allows you to use \fBgetopt\fP(1)
+like parameter parsing in your program.
+.P
+You can either use the appropriate hotkey (see list above) to launch the
+handler with the currently loaded URI, or you can perform a right click
+on any link, image or media file to use that URI.
+.P
+This mechanism allows you to implement a variety of functions. You might
+want to implement a bookmarking script or a password manager or you
+might simply load the current URI in a different browser. That's up to
+you.
+.\" --------------------------------------------------------------------
.SH "USING LARIZA WITH TABBED"
By default, \fBlariza\fP automatically launches an instance of suckless'
\fBtabbed\fP(1).