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