org-babel-latex-process-alist: Use latemk or run latex trice

* lisp/ob-latex.el (org-babel-latex-process-alist): Change the default
value to using latexmk/latex x 3, so that references are resolved.
* etc/ORG-NEWS (The default value of
~org-babel-latex-process-alist~...): Announce the change.

Link: https://list.orgmode.org/orgmode/87cyretut7.fsf@localhost/
This commit is contained in:
Ihor Radchenko 2024-06-03 16:31:09 +02:00
parent 4ee373cb75
commit c426f49364
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
2 changed files with 24 additions and 5 deletions

View File

@ -18,16 +18,23 @@ Please send Org bug reports to mailto:emacs-orgmode@gnu.org.
# require user action for most Org mode users.
# Sorted from most important to least important.
** New features
# We list the most important features, and the features that may
# require user action to be used.
** New and changed options
# Chanes deadling with changing default values of customizations,
# adding new customizations, or changing the interpretation of the
# existing customizations.
** New features
*** The default value of ~org-babel-latex-process-alist~ is no longer taken from ~org-preview-latex-process-alist~
# We list the most important features, and the features that may
# require user action to be used.
The default value used to be pulled from =dvipng= process type from
~org-preview-latex-process-alist~. Now, it defaults to using
=latexmk= (when available), or running =latex= multiple times, so that
all the references are resolved in the generated png.
** New functions and changes in function arguments

View File

@ -130,14 +130,26 @@ exporting the literal LaTeX source."
:type '(repeat (string)))
(defcustom org-babel-latex-process-alist
`(,(cons 'png (alist-get 'dvipng org-preview-latex-process-alist)))
`((png :programs ("latex" "dvipng") :description "dvi > png"
:message
"you need to install the programs: latex and dvipng."
:image-input-type "dvi" :image-output-type "png"
:image-size-adjust (1.0 . 1.0) :latex-compiler
,(if (executable-find "latexmk")
'("latexmk -f -pdf -latex -interaction=nonstopmode -output-directory=%o %f")
'("latex -interaction nonstopmode -output-directory %o %f"
"latex -interaction nonstopmode -output-directory %o %f"
"latex -interaction nonstopmode -output-directory %o %f"))
:image-converter ("dvipng -D %D -T tight -o %O %f")
:transparent-image-converter
("dvipng -D %D -T tight -bg Transparent -o %O %f")))
"Definitions of external processes for LaTeX result generation.
See `org-preview-latex-process-alist' for more details.
The following process symbols are recognized:
- `png' :: Process used to produce .png output."
:group 'org-babel
:package-version '(Org . "9.7")
:package-version '(Org . "9.8")
:type '(alist :tag "LaTeX to image backends"
:value-type (plist)))