Don't use forced mode for Latexmk

This commit is contained in:
jfbu 2017-05-07 15:45:55 +02:00
parent 832f537703
commit 97625a2c5c
2 changed files with 10 additions and 22 deletions

View File

@ -202,30 +202,18 @@ The builder's "name" must be given to the **-b** command-line option of
.. versionchanged:: 1.6
Use of ``latexmk`` on GNU/Linux or Mac OS X.
Since 1.6, ``make latexpdf`` (or ``make -C "<builddir>/latex"`` after a
``sphinx-build`` run) uses ``latexmk`` (on GNU/Linux and Mac OS X).
It invokes it with option ``-f`` which attempts to complete targets
even in case of LaTeX processing errors. This can be overridden via
``LATEXMKOPTS`` variable, for example:
Since 1.6, and on GNU/Linux and Mac OS X, ``make latexpdf`` (or
``make -C "<builddir>/latex"`` after a ``sphinx-build`` run) uses
``latexmk``. One can pass to ``latexmk`` options via the ``LATEXMKOPTS``
Makefile variable. For example:
.. code-block:: console
make latexpdf LATEXMKOPTS=""
make latexpdf LATEXMKOPTS="-silent"
The ``pdflatex`` calls themselves obey the ``LATEXOPTS`` variable whose
default is ``--interaction=nonstopmode`` (same as ``-interaction
nonstopmode``.) In order to stop the
compilation on first error one can use ``--halt-on-error``.
Example:
.. code-block:: console
make latexpdf LATEXMKOPTS="-silent" LATEXOPTS="--halt-on-error"
In case the first ``pdflatex`` run aborts with an error, this will stop
further ``latexmk`` processing (no ``-f`` option). The console output
will be kept to a bare minimum during target processing (``-silent``).
reduces console output to a minimum. To pass options directly to the
``pdflatex`` executable, use variable ``LATEXOPTS`` (for example
``LATEXOPTS="--interaction=nonstopmode"``).
.. autoattribute:: name

View File

@ -15,9 +15,9 @@ ALLIMGS = $(wildcard *.png *.gif *.jpg *.jpeg)
# Prefix for archive names
ARCHIVEPRREFIX =
# Additional LaTeX options (passed via variables in latexmkrc/latexmkjarc file)
export LATEXOPTS = --interaction=nonstopmode
export LATEXOPTS =
# Additional latexmk options
LATEXMKOPTS = -f
LATEXMKOPTS =
# format: pdf or dvi
FMT = pdf