From 101af91b8038023f2e20ded97c115ed7f39f99dd Mon Sep 17 00:00:00 2001 From: jfbu Date: Mon, 6 Feb 2017 13:55:25 +0100 Subject: [PATCH] more precise latex docs --- doc/latex.rst | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/doc/latex.rst b/doc/latex.rst index 75707026a..c36b3dc77 100644 --- a/doc/latex.rst +++ b/doc/latex.rst @@ -163,19 +163,24 @@ Here are the currently available options together with their default values. package to set the text width to an exact multiple of the *zenkaku* width of the base document font. - .. attention:: + .. hint:: - For a ``'manual'`` type document, which by default uses the ``jsbook`` - LaTeX document class, the dimension units must be so-called "true" - units:: + For a ``'manual'`` type document with :confval:`language` set to + ``'ja'``, which by default uses the ``jsbook`` LaTeX document class, the + dimension units, when the pointsize isn't ``10pt``, must be so-called TeX + "true" units:: 'sphinxsetup': 'hmargin=1.5truein, vmargin=1.5truein, marginpar=5zw', - This is due to the LaTeX class ``jsbook``'s way of handling the - pointsize when it is not ``10pt``. + This is due to the way the LaTeX class ``jsbook``'s handles the + pointsize. - To the contrary, the ``jreport`` class, which is used for ``'howto'`` - documents, must be configured with "normal" units. + Or, one uses regular units but with ``nomag`` as document class option. + This can be achieved for example via:: + + 'pointsize': 'nomag,12pt', + + in the :confval:`latex_elements` configuration variable. .. versionadded:: 1.5.3