diff options
author | Peter Hofmann <scm@uninformativ.de> | 2017-01-27 18:10:58 +0100 |
---|---|---|
committer | Peter Hofmann <scm@uninformativ.de> | 2017-01-27 18:10:58 +0100 |
commit | f9a96c0acd533e1d546784ca1db14e555bd44dd3 (patch) | |
tree | 2c9891260d4ed9c9a3c8ac31c0d7419d647bc2e1 /man1/lariza.usage.1 | |
parent | 4db88e219e31d2b7a2fc9f89b2e4abd63de787a2 (diff) | |
parent | 15e97c37a47437ba6c1d6a8557cf4be871029670 (diff) | |
download | lariza-f9a96c0acd533e1d546784ca1db14e555bd44dd3.tar.gz |
Merge branch 'external-handler'
Diffstat (limited to 'man1/lariza.usage.1')
-rw-r--r-- | man1/lariza.usage.1 | 33 |
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). |