diff --git a/CHANGES b/CHANGES index 7aa23a61c..e0b098db5 100644 --- a/CHANGES +++ b/CHANGES @@ -50,6 +50,8 @@ Features added * LaTeX: support elliptical corners in rounded boxes. (refs: #11254) * #11150: Include source location in highlighting warnings, when lexing fails. Patch by Jeremy Maitin-Shepard +* #11281: Support for :confval:`imgmath_latex` ``= 'tectonic'`` or + ``= 'xelatex'``. Patch by Dimitar Dimitrov Bugs fixed ---------- diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst index 9ce3efe4f..df4fc6b84 100644 --- a/doc/usage/extensions/math.rst +++ b/doc/usage/extensions/math.rst @@ -80,6 +80,18 @@ are built: This value should only contain the path to the latex executable, not further arguments; use :confval:`imgmath_latex_args` for that purpose. + .. hint:: + + To use `OpenType Math fonts`__ with ``unicode-math``, via a custom + :confval:`imgmath_latex_preamble`, you can set :confval:`imgmath_latex` + to ``'dvilualatex'``, but must then set :confval:`imgmath_image_format` + to ``'svg'``. Note: this has only been tested with ``dvisvgm 3.0.3``. + It significantly increases image production duration compared to using + standard ``'latex'`` with traditional TeX math fonts. + + __ https://tex.stackexchange.com/questions/425098/which-opentype-math-fonts-are-available + + .. hint:: Some fancy LaTeX mark-up (an example was reported which used TikZ to add @@ -88,6 +100,19 @@ are built: ``'latexmk'`` (or a full path to it) as this Perl script reliably chooses dynamically how many latex runs are needed. + .. versionchanged:: 6.2.0 + + Using ``'xelatex'`` (or a full path to it) is now supported. But you + must then add ``'-no-pdf'`` to the :confval:`imgmath_latex_args` list of + the command options. The ``'svg'`` :confval:`imgmath_image_format` is + required. Also, you may need the ``dvisvgm`` binary to be relatively + recent (testing was done only with its ``3.0.3`` release). + + .. note:: + + Regarding the previous note, it is currently not supported to use + ``latexmk`` with option ``-xelatex``. + .. confval:: imgmath_latex_args Additional arguments to give to latex, as a list. The default is an empty