[tip] LaTeX preview of a region

[tip] LaTeX preview of a region

[Juan Manuel Macías]

Hi all,

When typesetting a long book, I often need to fine tune many paragraphs
(typographically speaking). So I've write this code to avoid compiling
the whole document every time. The idea is activate a preview of any
region of the document, compiled with all the local configuration
(export filters, setup file, export options, etc.). In other words, the
preview *must be identical* to the compiled/exported pdf. Although it is
for a particular use case, I share it here in case it is useful to
someone.

My intention is to give these four variables a local value for each
document or major project. But this would be the default value:

#+begin_src emacs-lisp
  (setq my-prev/preamble "preamble.tex"
  	my-prev/env-begin "@@latex:\\begin{dummy}@@"
  	my-prev/env-end "@@latex:\\end{dummy}@@"
  	my-prev/conf "#+OPTIONS: ':t\n
		      #+LANGUAGE: es\n"
                      #+SETUPFILE: normal.setup\n
                      #+INCLUDE: export-filters\n")
#+end_src

The first variable makes sense because I always use a separate file as a
preamble for large projects. The second and third variables correspond
to the environment to enclose the preview (by default, a `dummmy'
environment: `\newenvironment*{dummy}{}{}'). And the fourth is the
configuration to export the preview.

And these two functions enable or disable the preview on a region (here
a sample video:
https://lunotipia.juanmanuelmacias.com/images/latex-preview.mp4):

#+begin_src emacs-lisp
  (defun my-org-latex-prev-region ()
    (interactive)
    (let* ((frag (save-restriction
		   (narrow-to-region (region-beginning) (region-end))
		   (buffer-string)))
	   (my-prev/preamble-l (buffer-local-value 'my-prev/preamble (current-buffer)))
	   (my-prev/env-begin-l (buffer-local-value 'my-prev/env-begin (current-buffer)))
	   (my-prev/env-end-l (buffer-local-value 'my-prev/env-end (current-buffer)))
	   (my-prev/conf-l (buffer-local-value 'my-prev/conf (current-buffer)))
	   (org-preview-latex-default-process 'luamagick)
	   (org-format-latex-header (concat (with-temp-buffer
					      (insert-file-contents my-prev/preamble-l)
					      (buffer-string)) "\n"
					      "\\pagestyle{empty}"))
	   (prev (with-temp-buffer
		  (insert (concat my-prev/conf-l "\n\n" my-prev/env-begin-l "\n\n" frag "\n\n" my-prev/env-end-l))
		  (mark-whole-buffer)
		  (org-latex-convert-region-to-latex)
		  (org-latex-preview)
		  (goto-char (point-min))
		  (overlay-get  (car (overlays-at (point))) 'display))))
      (let*
	  ((ov (make-overlay (region-beginning) (region-end))))
	(overlay-put ov 'overlay-latex-prev t)
	(overlay-put ov 'display prev))))

(defun my-org-latex-remove-prev-region ()
    (interactive)
    (remove-overlays nil nil 'overlay-latex-prev t))
#+end_src


Best regards,

Juan Manuel