From 140d9ebd912ed803dd916c6ab3783a79a2a724e3 Mon Sep 17 00:00:00 2001
From: Rodrigo Arias Mallo <rodarima@gmail.com>
Date: Fri, 14 Jun 2024 22:27:18 +0200
Subject: Add support for user actions in the link menu

Allows the user to define additional entries in the link menu which will
execute the given program/script. Each actions is defined using the
"link_action" option. The link URL is stored in the $url enviroment
variable and the current page in $origin, so the user can customize how
do the handling.

Here is a simple example to add three new entries:

    link_action="Debug variables:echo url=$url origin=$origin"
    link_action="Open in MPV:mpv $url"
    link_action="Open in Firefox:firefox $url"

The command is spawned in a forked process using the system() call,
which uses the shell to expand any variable. In particular, the $url
variable is set to the current URL being opened.

Fixes: https://github.com/dillo-browser/dillo/issues/3
---
 dillorc | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'dillorc')

diff --git a/dillorc b/dillorc
index 88afe11a..484185c2 100644
--- a/dillorc
+++ b/dillorc
@@ -64,6 +64,17 @@
 # jump to a given position.
 #scrollbar_page_mode=NO
 
+# Define custom actions for the link menu. The format is <label>:<cmd>. The
+# command will be executed in the system shell using the system() call. You can
+# implement your own handling logic in a script or program. The following
+# environment variables are set:
+#   $url:    URL being opened
+#   $origin: URL of the current document
+# Examples:
+# link_action="Debug variables:echo url=$url origin=$origin"
+# link_action="Open in MPV:mpv $url"
+# link_action="Open in Firefox:firefox $url"
+
 #-------------------------------------------------------------------------
 #                           RENDERING SECTION
 #-------------------------------------------------------------------------
-- 
cgit v1.2.3