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

[Bruno Barbier]

Hi Max,

Max Nikulin <manikulin@gmail.com> writes:
> 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.

Looks good to me.

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

Not that one, that I'm using only when forced to use win32!
(else, I'm a very happy user of notmuch)

Thanks Max!

Bruno


> 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