From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id SDiHNJk9XmTQ9QAASxT56A (envelope-from ) for ; Fri, 12 May 2023 15:22:33 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id eH56NJk9XmRWEwAAauVa8A (envelope-from ) for ; Fri, 12 May 2023 15:22:33 +0200 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 7BBB888E6 for ; Fri, 12 May 2023 15:22:33 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pxSiO-0006s3-Sw; Fri, 12 May 2023 09:21:44 -0400 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 1pxSiK-0006ru-IZ for emacs-orgmode@gnu.org; Fri, 12 May 2023 09:21:41 -0400 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 1pxSiE-0007Ap-BV for emacs-orgmode@gnu.org; Fri, 12 May 2023 09:21:40 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 1135B240125 for ; Fri, 12 May 2023 15:21:31 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1683897692; bh=AGW09eNNX60vK8gZlF6GrPqQNMudnSeqPhROKTTKP2w=; h=From:To:Subject:Date:Message-ID:MIME-Version:From; b=EB3wSDqKSVO88EmOTaAPa2zUNUcRgx4vPLcVKFQJa2s3xAGWVWMz/VgaqgB8eO34k 6XDiDOgHcrWqdDdJxJeMrSxZnw/Aryyws/TiofEmsiH7CYtpC8YmfcnLye4K9mA8i0 hQ7QPOcC6MuoxhWmf9/4754GTHGqmHHJVAMqExM49ZmZfJdpI6qhQ3zNOA2Vmpja9J z1TTEPqjO637wAY8LatKVGajWMHi9C5qSkj2m+nqV45M2Bmqqam4yqoeOvDFDFNuGe stiX1pPjXcIfoT2Av0FVhhb9TaoUrNpAaFIlKJ47+o9t00cxzVzdMhSYGK3TZpwkm7 qleflQmowQP+g== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4QHqCv3vCfz9rxM for ; Fri, 12 May 2023 15:21:31 +0200 (CEST) From: Ihor Radchenko To: emacs-orgmode@gnu.org Subject: [PATCH] doc/org-manual.org: Document `org-latex-src-block-backend' Date: Fri, 12 May 2023 13:24:58 +0000 Message-ID: <87wn1dznpx.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: -39 X-Spam_score: -4.0 X-Spam_bar: ---- X-Spam_report: (-4.0 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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 ARC-Seal: i=1; s=key1; d=yhetil.org; t=1683897753; a=rsa-sha256; cv=none; b=HIjK6rYc/4aWyjG1P6OQzUfXBzhk22wTVEFmlDd/gQNckjiKJsD9zpVpBbHbqlzxFtUXiX 0JutdYrx1rT+wJTeF8YYJfxrfKGEcOtl3LoC7BqceW1IZDoB7VLEcL8sfkbqlzwlK/j1br o8/d7ZhUGEoaPtcUBKjNy8WRarliKncAiw3KEDGEvhMu8og+iv7/d5qdQMhPJga23RnEbE SIyvRTABDG1SM3DDgQSX6nq2ojT3Z0EtTbeNf0CuOO6TJox+Omjrj6VE/w1B1QwZJa4Nij NNn7++EVwrIizII8Wv3qfD/g8UJUpOSiWtZKL1+0uVWGLU5L/ZuteIIDAv0XEw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=EB3wSDqK; 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=1683897753; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=8I5LXm4R9Sm9pdIMgCxmoDTAqDaFz5A5kXZFSu25GtM=; b=uNEdVUMFMUCZyjEkyM5+YHew7HRaoJP8dbkQQ/fftwkR0oB5NTl6Yk2/QwAH4aVYtZZZil A5eyPKc8WRvMFV8rAUgTNhKtaNCznAvKC1qqv7ZuUw7fR6zdCo7cZiEFV0PGmh2j4uVP+D 38nT7pSdRU+EbzSXd3uFgt5x4v29FKRCkJ4Hgpm6ogacUYzpMZ0gOUULDn9H2apCiO/aQh LMYbge8HsacEcklFdoAb1j9jNXQjy1W/OJ6wPb8knzyEsxVzfiHffWzXeciMu5/wlZNykT yXdRg3V8HOeGSEkmpkFkZiZkjsED8u4fQHp5ckrrbmg/7Db0fRxoVZN2i5nIyw== X-Migadu-Scanner: scn1.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=EB3wSDqK; 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" X-Migadu-Spam-Score: -6.16 X-Spam-Score: -6.16 X-Migadu-Queue-Id: 7BBB888E6 X-TUID: f5bTv/P2Fu9v --=-=-= Content-Type: text/plain Attaching tentative manual patch that explains about `org-latex-src-block-backend'. There was no explanation about different ways to export colored source blocks in the past. Please try to read and let me know if anything is confusing. --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-doc-org-manual.org-Document-org-latex-src-block-back.patch >From fb77ae66d4d9c01a350140481bcb0f030a45fb69 Mon Sep 17 00:00:00 2001 Message-Id: From: Ihor Radchenko Date: Fri, 12 May 2023 15:21:59 +0200 Subject: [PATCH] doc/org-manual.org: Document `org-latex-src-block-backend' * doc/org-manual.org (Source blocks in LaTeX export): Explain possible LaTeX export options for source blocks. --- doc/org-manual.org | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/doc/org-manual.org b/doc/org-manual.org index ba9fdaf20..4e56a1e00 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -14181,6 +14181,37 @@ *** Source blocks in LaTeX export #+cindex: source blocks, in @LaTeX{} export #+cindex: @samp{ATTR_LATEX}, keyword +#+vindex: org-latex-src-block-backend +LaTeX export backend provides multiple ways to render src blocks in +LaTeX, according to the value of ~org-latex-src-block-backend~: + +- =verbatim= (default) :: + + Use =verbatim= LaTeX environment with no language-specific + fontification. + +- =listings= :: + + Use =listings= environment provided by the corresponding LaTeX + package. Org will not add the =listings= package to LaTeX preamble, + users need to customize ~org-latex-packages-alist~ or LaTeX headers + manually. + +- =minted= :: + + Use more syntax-aware =minted= package. Note that in addition to + customizing the LaTeX preamble, [[https://pygments.org][pygments]] + program should be installed and ~org-latex-pdf-process~ should pass + =-shell-escape= option to LaTeX executable. + +- =engraved= :: + + Use =fvextra= LaTeX package and Emacs package + [[https://elpa.gnu.org/packages/engrave-faces][engrave-faces]] + available on GNU Elpa. =engrave-faces= will use Emacs fontification + to colorize the source blocks in LaTeX output. + + The LaTeX export backend can make source code blocks into floating objects through the attributes =:float= and =:options=. For =:float=: -- 2.40.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 --=-=-=--