IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Update doc and CHANGES for PR #11281

Browse Source
This commit is contained in:
Jean-François B 2023-04-03 10:55:31 +02:00
parent a2ec68fa72
commit e1b15a5c11
2 changed files with 27 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
CHANGES
View File

@ -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
----------

25
doc/usage/extensions/math.rst
View File

@ -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