gav451
/
emacs.d
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

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
1 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
README.org
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
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
=htmlized= in case of HTML export. The listings below work around three issues
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
quality of the export results of this [[file:README.org][README.org]] to a level acceptable for my
workflow:
=htmlized= in case of HTML export.
The listings below work around two issues with spacing in the =pdf= output
resulting from use of the =engraved= source block back-end during =LaTeX=
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=
output with a non-equidistant interline spacing in floating listings and
equidistant interline spaces non-floating =tcolorbox= environments. I have
traced the non-equidistant interline spacing back to the =breakable= option
of =Code= environments inside =listing= environments. However, =tcolorbox=
requires =breakable= for listings that do not fit on a page. The filter
output with a non-equidistant interline spacing in floating listings (those
with captions) and equidistant interline spaces non-floating =tcolorbox=
environments (those without captions). I have traced the non-equidistant
interline spacing back to the =breakable= option of =Code= environments
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
[[lst:org-latex-engraved-source-block-filter]] and the
=org-latex-engraved-preamble= customization in listing