From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id 0NvsNEgJRmcWJAEA62LTzQ:P1 (envelope-from ) for ; Tue, 26 Nov 2024 17:45:44 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id 0NvsNEgJRmcWJAEA62LTzQ (envelope-from ) for ; Tue, 26 Nov 2024 18:45:44 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=TuSPZhEP; dmarc=pass (policy=none) header.from=posteo.net; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1732643144; a=rsa-sha256; cv=none; b=Pt7enzluQHrQl82zwPWj1pEeA0iFAStdusxG4Ka2/7mtlAq48B+uOJLWIFuPO2T99wcL6B SWj597TydFzvfPaLhVKUzPN2aiL8rMcIkaSnPOyFygWtq7xT8Ua9hNYFpxz9wNi9qyuocx JrfsmHhRE4KsLFgXol/jgznrsOCBd0Ek2j4yzc0QDvzRacfbKP+ISdheyx+nKFSWJw7mD2 5WjsU/h8MBcdjqXlueZCFTDrWepn61qVAp3tC5HLu8Vt9RSFb2ESqbBli2m8R5TpDQcvqM 87ug1UCemMUJevDvqH8wcHPBbt7SKdPbngshdOpsOTpNUMGUiF6/RaHOF1Vt6w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=TuSPZhEP; dmarc=pass (policy=none) header.from=posteo.net; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1732643144; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=FdzRkOvI0+zl2ClixYf3TcoEOYmoPgI/ZdHjR5wWKi4=; b=Vaqk8I+W5aT3hAooQYoGj0WJ8LbetKHQqsXcNp0MiFiDsdSEnN1xcygHzH4h6I9FoYTcTr +7xfJkkL2lmeOnNBo8qc7Au3pqIDhn+UQwSuC9gOj00EbdagSABQusP6OFEY/xgolXzUWg yqYOhaHXsUjSWh9+ANz9qnpZ/r867I0eAmWCppc391WICvETI4CmEV8EIxnQRmeH96jBJt nsljA2C+LmUm3EHDguaavLHvXXgIcL29AcL179gdHwpVyfxDKG5TvmbnvEMnV4q1RzIUFe GH1+qf3t7VlkDpsUdzX39zWzOHdDEzaaoTBFeVIYwmUvfkAObK4Hy1EJgJ14Ww== Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 81A208773E for ; Tue, 26 Nov 2024 18:45:44 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tFzcg-00024g-CU; Tue, 26 Nov 2024 12:45:14 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tFzcX-000228-Du for emacs-orgmode@gnu.org; Tue, 26 Nov 2024 12:45:09 -0500 Received: from mout01.posteo.de ([185.67.36.65]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tFzcP-0001oW-Be for emacs-orgmode@gnu.org; Tue, 26 Nov 2024 12:45:00 -0500 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 0F8B7240028 for ; Tue, 26 Nov 2024 18:44:53 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1732643094; bh=cdGvZhhYSbWgn8lOKimI3B+EAmgKE6mgpzljPHZTf8k=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type: From; b=TuSPZhEP3Rd8JYs5b+XdKoMqFhVc3VGMkwg0Q3vCLCSnFRuojpBVRbfVwRHEbVr1u cvqiGwdjPQMgfSeham7HqWtBYpl2vptZOwqvyDYwA+llJzYKcnE/S4rFLJMVVptgeT s+prZYEh60M+DFGIf0GyZfZnq2j0qw5G1quMbMD+S6jtXOhqzAiLf2J1nw0A365H76 r/Ok8KDLmB/2I4+uF04of2mzYQ+ajKW6Qqdq87RuIPuD/SQ+uM3+3Yj4ChmOOMC9UG 7Al4dcE/TPKUhmdLXEQUTYKbSRSbM+4bGy89XvCMWPfwrFM8annavWngGBtIudvpfz y2W4z4nnPB8lQ== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4XyVMT05ldz9rxB; Tue, 26 Nov 2024 18:44:52 +0100 (CET) From: Ihor Radchenko To: Karthik Chikmagalur Cc: stardiviner , Org mode Subject: Re: [PATCH v11] Inline image display as part of a new org-link-preview system In-Reply-To: <87bjy1q5fz.fsf@localhost> References: <6461a84b.a70a0220.b6d36.5d00@mx.google.com> <87r08nkhfg.fsf@localhost> <874j5jfy8y.fsf@gmail.com> <875xpxu47h.fsf@localhost> <87h68weovw.fsf@gmail.com> <875xpcks8a.fsf@localhost> <87a5enevy5.fsf@gmail.com> <877c9qeohj.fsf@localhost> <87msimtz88.fsf@gmail.com> <87plnh7azl.fsf@localhost> <87v7x9z7y6.fsf@gmail.com> <87cyjgcf48.fsf@localhost> <87iksqmktm.fsf@gmail.com> <87msi1eo07.fsf@localhost> <87frntmpq4.fsf@gmail.com> <87r075ckql.fsf@gmail.com> <87a5dq9bt9.fsf@localhost> <87bjy4c895.fsf@gmail.com> <87jzcri3pe.fsf@localhost> <87r06yvm1g.fsf@gmail.com> <87bjy1q5fz.fsf@localhost> Date: Tue, 26 Nov 2024 17:46:26 +0000 Message-ID: <87iks9opl9.fsf@localhost> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net; helo=mout01.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -1.82 X-Spam-Score: -1.82 X-Migadu-Queue-Id: 81A208773E X-Migadu-Scanner: mx12.migadu.com X-TUID: wWV6lms4lPMD --=-=-= Content-Type: text/plain Ihor Radchenko writes: > Karthik Chikmagalur writes: > >>> See the attached further adjustments to the manual. >> >> Ihor, many of the adjustments you made are how it was previously >> written -- links with descriptions are exported awkwardly to LaTeX in >> the document you sent me. I changed links with descriptions to links without >> descriptions and added a "(see [[foo]])" comment, but in your patch >> you've changed them back. > > Oops. My patch happens to be exactly the opposite of my changes. (I > chose wrong direction of the diff range) Here is the correct diff. --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-Adjustments-to-the-manual.patch >From ef65b9f4c2e46216f862169ecaee0d9cea09e290 Mon Sep 17 00:00:00 2001 Message-ID: From: Ihor Radchenko Date: Tue, 26 Nov 2024 18:45:32 +0100 Subject: [PATCH] Adjustments to the manual --- doc/org-manual.org | 43 +++++++++++++++++++++++-------------------- 1 file changed, 23 insertions(+), 20 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 3a4840d56f..95846b4758 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -11780,18 +11780,20 @@ ** Literal Examples ** Images and link previews :PROPERTIES: -:DESCRIPTION: Preview links in the buffer. +:DESCRIPTION: Preview links in the buffer :END: -Org mode can display previews of [[*Hyperlinks][hyperlinks]] inside Org -buffers. By default, only image links[fn::Image links are =file:= and -=attachment:= links to existing image files; Emacs should be able to -display the linked images (see ~image-types~ variable)] can be previewed -inline, where the images are displayed in place of the link path. +Org mode can display previews of hyperlinks (see [[*Hyperlinks]]) +inside Org buffers. By default, only image links[fn::Image links are +=file:= and =attachment:= links to existing image files; Emacs can +only display the linked images listed in ~image-types~ variable] can +be previewed inline, where the images are displayed in place of the +link path. -You can customize the previews as described in the [[*Adding Hyperlink -preview]] section. Link previews do not have to display images -- any -overlay property (see [[info:elisp#Overlay Properties]]) can be used. +You can customize the previews as described in [[*Adding Hyperlink +preview]]. Link previews do not have to display images -- any kind of +display decoration (see [[info:elisp#Overlay Properties]]) can be +used. You can preview the supported link types in the whole buffer, in the current section, active region or at point with the following commands: @@ -11800,11 +11802,12 @@ ** Images and link previews #+kindex: C-c C-x C-v #+findex: org-link-preview - Create inline previews for external links in the active region, the - link at point or in the current section. With a prefix argument, - clear link previews at point or in the current entry. With a double - prefix argument, preview all links in the buffer. With triple - prefix argument, hide previews for all links in the buffer. + Create inline previews for external links in the active region, if + any; the link at point, if there is such; or in the current section + otherwise. With a prefix argument, clear link previews at point or + in the current entry. With a double prefix argument, preview all + links in the buffer. With triple prefix argument, hide previews for + all links in the buffer. By default, only links without descriptions are previewed. You can force displaying previews for all supported links (including @@ -11827,14 +11830,14 @@ ** Images and link previews Assure inline display of external link previews in the whole buffer and refresh them. -- (~org-link-preview-region~) :: +- {{{kbd(M-x org-link-preview-region)}}} :: #+findex: org-link-preview-region Create inline previews for external links in the active region, or the buffer. With a prefix argument, also preview links with a text description part. -- (~org-link-preview-clear~) :: +- {{{kbd(M-x org-link-preview-clear)}}} :: #+findex: org-link-preview-clear Clear external link previews in the active region, or the buffer. @@ -11870,8 +11873,8 @@ *** Images [[./img/a.jpg]] #+end_example -When [[*Images and link previews][link previews]] are displayed as -images, the image size and alignment can be further customized. +When link previews are displayed as images, the image size and +alignment can be further customized. #+vindex: org-image-actual-width #+vindex: org-image-max-width @@ -21911,7 +21914,7 @@ ** Adding Hyperlink preview In our example, we use the =convert= program (part of the =imagemagick= suite of tools) to create the thumbnail that is displayed inline. - + #+begin_src emacs-lisp (defun org-link-docview-preview (ov path _elem) "Preview file at PATH in overlay OV. @@ -21938,7 +21941,7 @@ ** Adding Hyperlink preview 3. Now previews of docview links for supported document types (PDF, djvu) are generated (along with image file previews) when calling ~org-link-preview~. - + ** Adding Export Backends :PROPERTIES: :DESCRIPTION: How to write new export backends. -- 2.47.0 --=-=-= Content-Type: text/plain -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at --=-=-=--