summaryrefslogtreecommitdiff
path: root/man1/lariza.usage.1
diff options
context:
space:
mode:
Diffstat (limited to 'man1/lariza.usage.1')
-rw-r--r--man1/lariza.usage.133
1 files changed, 33 insertions, 0 deletions
diff --git a/man1/lariza.usage.1 b/man1/lariza.usage.1
index 0b047ea..f89c3db 100644
--- a/man1/lariza.usage.1
+++ b/man1/lariza.usage.1
@@ -45,6 +45,9 @@ touched. Instead, the new file name will have a suffix such as \fB.1\fP,
.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
@@ -107,6 +110,9 @@ Reset zoom to $\fBLARIZA_ZOOM\fP.
.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
@@ -176,6 +182,33 @@ Note: 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 "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).