Improve the `engrave-faces' section again

This commit is contained in:
Gerard Vermeulen 2023-01-02 14:58:26 +01:00
parent c324cdb5ec
commit 3cccc9a200

View File

@ -2467,17 +2467,20 @@ valid directories and files. In an [[https://orgmode.org/][Org-mode]] buffer th
This package has a front-end that processes fontified buffers and pipes its This package has a front-end that processes fontified buffers and pipes its
output into one of three back-ends for export to LaTeX, HTML and text with ANSI output into one of three back-ends for export to LaTeX, HTML and text with ANSI
escape codes. It is an alternative to =minted= in case of LaTeX export or to escape codes. It is an alternative to =minted= in case of LaTeX export or to
=htmlized= in case of HTML export. The listings below work around three issues =htmlized= in case of HTML export.
with spacing in the =pdf= output resulting from =LaTeX= export by means of [[info:org#Source blocks in LaTeXexport][Org
source block export to LaTeX (info)]] and [[https://github.com/tecosaur/engrave-faces#readme][Engrave Faces]]. They increase the The listings below work around two issues with spacing in the =pdf= output
quality of the export results of this [[file:README.org][README.org]] to a level acceptable for my resulting from use of the =engraved= source block back-end during =LaTeX=
workflow: export, and one isssue with symbolic color names in faces. They increase the
quality of the export results of this [[file:README.org][README.org]] and the user-friendliness of
this facility to a level acceptable for my workflow:
1. The default Org export configuration for engraving listings produces =pdf= 1. The default Org export configuration for engraving listings produces =pdf=
output with a non-equidistant interline spacing in floating listings and output with a non-equidistant interline spacing in floating listings (those
equidistant interline spaces non-floating =tcolorbox= environments. I have with captions) and equidistant interline spaces non-floating =tcolorbox=
traced the non-equidistant interline spacing back to the =breakable= option environments (those without captions). I have traced the non-equidistant
of =Code= environments inside =listing= environments. However, =tcolorbox= interline spacing back to the =breakable= option of =Code= environments
requires =breakable= for listings that do not fit on a page. The filter inside =listing= environments. However, =tcolorbox= requires =breakable= for
listings that do not fit on a page. The filter
=org-latex-engraved-source-block-filter= in listing =org-latex-engraved-source-block-filter= in listing
[[lst:org-latex-engraved-source-block-filter]] and the [[lst:org-latex-engraved-source-block-filter]] and the
=org-latex-engraved-preamble= customization in listing =org-latex-engraved-preamble= customization in listing