[PATCH] worg/org-faq.org: Recommend cb_thunderlink Thunderbird add-on

[Max Nikulin <manikulin@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 406 bytes --]

On 06/02/2023 18:46, Bruno Barbier wrote:
> 
> After asking Thunderbird to register itself as the default mail
> application, "mid:" seems to be working from everywhere.

A have prepared an alternative patch. Let me know if have suggestions, 
objections, or if you prefer to proceed with another revision of your patch.

It seems you had no plan to polish your Org and system configuration to 
such degree.

[-- Attachment #2: 0001-org-faq.org-Recommend-cb_thunderlink-Thunderbird-add.patch --]
[-- Type: text/x-patch, Size: 4123 bytes --]

From a1b3a81bbc11fd2f55096cc2e29f97797b80b915 Mon Sep 17 00:00:00 2001
From: Max Nikulin <manikulin@gmail.com>
Date: Tue, 7 Feb 2023 21:49:06 +0700
Subject: [PATCH] org-faq.org: Recommend cb_thunderlink Thunderbird add-on

* org-faq.org (Thunderbird emails): Add CUSTOM_ID property to have
stable anchor during HTML export.  Recommend cb_thunderlink extension as a
means to generate mid: links and to handle existing thunderlink: ones.
Add a note that on Windows Thunderbird should register itself as a
handler of the mid: protocol.

Thanks to Bruno Barbier for discussion on the emacs-orgmode
mailing list.
---
 org-faq.org | 37 +++++++++++++++++++++++++++++--------
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/org-faq.org b/org-faq.org
index 0410d368..a7db75c1 100644
--- a/org-faq.org
+++ b/org-faq.org
@@ -1999,13 +1999,16 @@ ** Can I use CamelCase links?
 consult the [[https://orgmode.org/worg/org-contrib/org-wikinodes.html][documentation]].
 
 ** Can I create links to Thunderbirds emails?
+:PROPERTIES:
+:CUSTOM_ID: mid-url-handler
+:END:
 
 Thunderbird-91 and later versions support =mid:= URI scheme proposed
-many years ago, see
-[[https://www.rfc-editor.org/rfc/rfc2392.html][RFC 2392 - Content-ID and Message-ID Uniform Resource Locators]]
-for details.  To create a link you need to copy the value of the
-Message-ID header, it should be possible with some add-on.  As the
-last resort you may obtain the identifier by opening message source
+many years ago in
+[[https://www.rfc-editor.org/rfc/rfc2392.html][RFC 2392 - Content-ID and Message-ID Uniform Resource Locators]].
+To create a link you need to copy the value of the Message-ID header.
+It requires installing some add-on, see =cb_thunderlink= example below.
+As the last resort you may obtain the identifier by opening message source
 (=Ctrl+U=).  Message-ID resembles email address but has a unique
 string in the local (user) part.  Remove angle brackets and prepend
 the inner part with =mid:= to create a link.  A command to open the
@@ -2034,6 +2037,10 @@ ** Can I create links to Thunderbirds emails?
 [Default Applications]
 x-scheme-handler/mid=thunderbird.desktop;
 #+END_EXAMPLE
+On Windows ensure that Thunderbird is installed as default handler
+for URI protocols related to mail.  This approach allows to have
+uniform handler withing Emacs, including
+[[https://www.gnu.org/software/emacs/manual/html_node/emacs/Goto-Address-mode.html][~goto-address-mode~]].
 
 Instead of calling ~browse-url~ and setting up the scheme handler
 you may launch thunderbird directly.  It is a bit tricky in Emacs,
@@ -2044,12 +2051,26 @@ ** Can I create links to Thunderbirds emails?
 the link:
 : thunderbird -mail 'imap-message://USER_NAME%40gmail.com@imap.googlemail.com/INBOX?messageId=ka42mn$mn9$1@ger.gmane.org'
 
+There is
+[[https://addons.thunderbird.net/thunderbird/addon/cb_thunderlink/][=cb_thunderlink= Thunderbird add-on]]
+that allows to generate links accordingly to configurable template, e.g.
+: [[mid:$msgid$][$author_name$: $subject$ ($date_iso$)]]
+See the
+[[https://list.orgmode.org/63d01412.050a0220.9611.9c4d@mx.google.com/][discussion]]
+on the emacs-orgmode mailing list.
+Additionally the extension may open messages using =thunderlink:=
+and =cbthunderlink:= protocols however it requires installing
+of a helper application.  These URI schemes may be registered in Org
+just as it is suggested for =mid:= links above.
+
 The ThunderLink add-on recommended earlier did not work since
-transition of Thunderbird from XUL add-ons to WebExtensions,
+transition of Thunderbird-78 from XUL add-ons to WebExtensions,
 so the following recipe is obsolete:
 [[http://list.orgmode.org/ka42mn$mn9$1@ger.gmane.org][from Christoph Herzog: Re: Linking to Thunderbird (correction)]].
-Notice that this link uses Message-ID to reference a particular
-message as well.
+To open earlier created =thunderlink:= links either
+install =cb_thunderlink= add-on or add to ~browse-url-handlers~ alist
+a function that extracts Message-ID and passes it to =mid:= protocol
+handler.
 
 * Plain Lists
   :PROPERTIES:
-- 
2.25.1