diff options
| author | Karl Berry <karl@freefriends.org> | 2012-09-12 22:14:06 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2012-09-12 22:14:06 +0000 |
| commit | 60134622cf5eb833e549dd5dfefb08a674b5a78c (patch) | |
| tree | 579dcaa6e820e1fba51249eb4c3c654c868c76b0 /Master/texmf-dist/doc/latex | |
| parent | 524f74405302fcc9daf66401d0da8485241764e9 (diff) | |
isomath (12sep12)
git-svn-id: svn://tug.org/texlive/trunk@27654 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/README.html | 109 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/README.txt | 52 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/isomath-test.pdf | bin | 351869 -> 147158 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/isomath-test.tex | 101 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/isomath.html | 1019 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/isomath.pdf | bin | 512685 -> 475097 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/isomath.sty.html | 322 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/isomath.sty.txt | 118 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/isomath/isomath.txt | 722 |
9 files changed, 1349 insertions, 1094 deletions
diff --git a/Master/texmf-dist/doc/latex/isomath/README.html b/Master/texmf-dist/doc/latex/isomath/README.html index 35e0cf95488..708196e29f7 100644 --- a/Master/texmf-dist/doc/latex/isomath/README.html +++ b/Master/texmf-dist/doc/latex/isomath/README.html @@ -3,15 +3,15 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.8: http://docutils.sourceforge.net/" /> -<title>isomath README</title> -<meta name="date" content="2011-02-01" /> -<meta name="copyright" content="© 2008, 2011 Günter Milde <milde@users.berlios.de>" /> +<meta name="generator" content="Docutils 0.10: http://docutils.sourceforge.net/" /> +<title>isomath</title> +<meta name="date" content="2012-09-04" /> +<meta name="copyright" content="© 2008, 2012 Günter Milde <milde@users.sf.net>" /> <style type="text/css"> /* :Author: David Goodger (goodger@python.org) -:Id: $Id: html4css1.css 6511 2011-01-03 14:49:11Z milde $ +:Id: $Id: html4css1.css 7434 2012-05-11 21:06:27Z milde $ :Copyright: This stylesheet has been placed in the public domain. Default cascading style sheet for the HTML output of Docutils. @@ -251,10 +251,18 @@ pre.address { margin-top: 0 ; font: inherit } -pre.literal-block, pre.doctest-block { +pre.literal-block, pre.doctest-block, pre.math, pre.code { margin-left: 2em ; margin-right: 2em } +pre.code .ln { /* line numbers */ + color: grey; +} + +.code { + background-color: #eeeeee +} + span.classifier { font-family: sans-serif ; font-style: oblique } @@ -365,7 +373,7 @@ dl.simple, dl.compact, dl.simple > dd, dl.compact > dd { } /* space around paragraphs */ -dl > dd p:first-child { +dl > dd p:first-child, td > p { margin: 0; } @@ -505,9 +513,10 @@ resulting list resembles the list-style 'outside' with a hanging indent. */ /* New ordered list: reset counter, suppress the default label */ -ol { +ol, ol.arabic, ol.loweralpha, ol.upperalpha, +ol.lowerroman, ol.upperroman { counter-reset: item; - list-style-type: none ! important; + list-style: none } /* Set the negative indent of the list label as feature of the list item */ @@ -516,7 +525,7 @@ ol > li { } /* reset for child elements */ ol > li > * { - text-indent: 0px; + text-indent: 0px; text-indent: 0; margin-top: 0; /* background: lightgreen; */ @@ -565,6 +574,12 @@ ol.nested > li:before, ol.nested ol > li:before { content: counters(item, ".") " "; } +/* lists nested in definition list */ + +dd > ul, dd > ol { + padding-left: 0pt; +} + /* TODO: prefix, suffix? */ /* smaller font for super- and subscripts */ @@ -576,11 +591,14 @@ ol.nested > li:before, ol.nested ol > li:before { /* margins and borders for "normal" tables */ table { - margin-top: 0.5em ; - margin-bottom: 0.5em; - border-style: outset; +/* background: magenta; */ + margin-top: 1em ; + margin-bottom: 1em; +/* border-style: outset; */ + border-style: solid; + border-color: silver; border-width: thin; - /* border-collapse: collapse; */ + border-collapse: collapse; } blockquote > table { margin-top: 0em ; @@ -588,8 +606,9 @@ blockquote > table { } td, th { - border-style: inset; + border-style: solid; border-width: thin; + border-color: silver; /* text-align: left; */ padding: 0 1ex; } @@ -611,7 +630,6 @@ table.booktabs { border: 0; border-top: 2px solid; border-bottom: 2px solid; - border-collapse: collapse; } table.booktabs * { @@ -623,6 +641,7 @@ table.booktabs th { table > caption { text-align: left; + margin-bottom: 0.25em /* padding: 2em 0 1em 0; */ } @@ -743,22 +762,28 @@ td, th { padding-top: 0.1ex; } -/* no borders for "borderless" tables */ -table.booktabs.borderless, table.booktabs.borderless * { - border-style: none; -} +/* let borderless overreide booktab */ +.booktabs.borderless, +table.booktabs.borderless td, table.booktabs.borderless th { + border: 0; + margin-left: 2em; + } + +table.docutils td, table.docutils th, + vertical-align: bottom; } </style> </head> <body> -<div class="document" id="isomath-readme"> -<h1 class="title">isomath README</h1> +<div class="document" id="isomath"> +<h1 class="title">isomath</h1> +<h2 class="subtitle" id="mathematical-style-for-science-and-technology">Mathematical style for science and technology</h2> <dl class="docinfo simple"> <dt class="date">Date</dt> -<dd class="date">2011-02-01</dd> +<dd class="date">2012-09-04</dd> <dt class="copyright">Copyright</dt> -<dd class="copyright">© 2008, 2011 Günter Milde <<a class="reference external" href="mailto:milde@users.berlios.de">milde@users.berlios.de</a>></dd> +<dd class="copyright">© 2008, 2012 Günter Milde <<a class="reference external" href="mailto:milde@users.sf.net">milde@users.sf.net</a>></dd> <dt>Licence</dt> <dd><p>This work may be distributed and/or modified under the conditions of the <a class="reference external" href="http://www.latex-project.org/lppl.txt">LaTeX Project Public License</a>, either @@ -767,10 +792,12 @@ version 1.3 of this license or (at your option) any later version.</p> </dl> <div class="abstract topic"> <p class="topic-title first">Abstract</p> -<p>The <cite>isomath</cite> package enables formatting Greek and Latin -letters as symbols for vectors, matrices, and tensors -in the typefaces recommended for scientific papers -by the International Standard ISO 80000-2.</p> +<p>The <cite>isomath</cite> package provides tools for a mathematical style +that conforms to the International Standard ISO 80000-2 and is +common in science and technology: capital Greek letters in italic +shape, bold italic and sans-serif bold italic math alphabets with +Latin and Greek characters, and macros for markup of vector, +matrix and tensor symbols.</p> </div> <div class="section" id="files"> <h1>Files</h1> @@ -779,12 +806,12 @@ by the International Standard ISO 80000-2.</p> <col width="32%" /> <col width="68%" /> </colgroup> -<tbody valign="top"> +<tbody> <tr><td><p>README.txt</p></td> <td><p>Requirements, Installation, Usage</p></td> </tr> <tr><td><p>README.html</p></td> -<td><p>browser friendly README</p></td> +<td><p>Requirements, Installation, Usage (HTML)</p></td> </tr> <tr><td><p>isomath.sty</p></td> <td><p>literate source (the actual LaTeX package)</p></td> @@ -814,7 +841,7 @@ by the International Standard ISO 80000-2.</p> </table> <p>The bidirectional text <-> code converter <a class="reference external" href="http://pylit.berlios.de">PyLit</a> can convert between <tt class="literal">isomath.sty</tt> and <tt class="literal">isomath.sty.txt</tt>.</p> -<p>The Python <a class="reference external" href="http://docutils.sourceforge.net/rst.html">Docutils</a> and pdflatex were used to generate the HTML and PDF +<p>The <a class="reference external" href="http://docutils.sourceforge.net/rst.html">Docutils</a> and pdflatex were used to generate the HTML and PDF documentation from the <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> sources.</p> </div> <div class="section" id="requirements"> @@ -827,20 +854,24 @@ bold italic</em> fonts matching with Computer Modern and derivatives.</p> </div> <div class="section" id="installation"> <h1>Installation</h1> -<ul> -<li><p>Unpack isomath.zip (preferably in a <a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">TDS</a> documentation folder).</p></li> -<li><p>Make sure LaTeX can find isomath.sty:</p> -<p>Copy/Move/Link it to a suitable place in the <a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">TDS</a> and run <tt class="literal">texhash</tt> -or place it in the current working directory (e.g. for testing).</p> -</li> +<p>If possible, get this package from your distribution using its installation +manager.</p> +<p>Otherwise, make sure LaTeX can find the file <cite>isomath.sty</cite>:</p> +<ul class="simple"> +<li><p>Download and unpack <cite>isomath.zip</cite> or just download <cite>isomath.sty</cite>.</p></li> +<li><p>Copy/Move/Link <tt class="literal">isomath.sty</tt> to a suitable place in the <a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">TDS</a> and run +<tt class="literal">texhash</tt>, or place it in the current working directory (e.g. for +testing).</p></li> </ul> </div> <div class="section" id="usage"> <h1>Usage</h1> +<p>Load the package and (optionally) change the default <tt class="literal">\vec</tt> macro with:</p> <pre class="literal-block">\usepackage{isomath} +\renewcommand{\vec}{\vectorsym} % optional </pre> -<p>Option description, more examples and usage hints are in the user -documentation.</p> +<p>Option description, more examples and usage hints are in the <a class="reference external" href="isomath.sty.html">user +documentation</a>.</p> <!-- References ========== --> </div> diff --git a/Master/texmf-dist/doc/latex/isomath/README.txt b/Master/texmf-dist/doc/latex/isomath/README.txt index 613161aac1d..107c024a5dc 100644 --- a/Master/texmf-dist/doc/latex/isomath/README.txt +++ b/Master/texmf-dist/doc/latex/isomath/README.txt @@ -1,24 +1,29 @@ -isomath README -~~~~~~~~~~~~~~ - -:Date: 2011-02-01 -:Copyright: © 2008, 2011 Günter Milde <milde@users.berlios.de> - +isomath +******* +Mathematical style for science and technology +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +:Author: Günter Milde +:Date: 2012-09-10 +:Copyright: © 2008, 2012 Günter Milde <milde@users.sf.net> :Licence: This work may be distributed and/or modified under the conditions of the `LaTeX Project Public License`_, either version 1.3 of this license or (at your option) any later version. -:Abstract: The `isomath` package enables formatting Greek and Latin - letters as symbols for vectors, matrices, and tensors - in the typefaces recommended for scientific papers - by the International Standard ISO 80000-2. +:Abstract: The `isomath` package provides tools for a mathematical style + that conforms to the International Standard ISO 80000-2 and is + common in science and technology. It changes the default shape of + capital Greek letters to italic, sets up bold italic and + sans-serif bold italic math alphabets with Latin and Greek + characters, and defines macros for markup of vector, matrix and + tensor symbols. Files ===== ==================== ================================= README.txt Requirements, Installation, Usage -README.html browser friendly README +README.html Requirements, Installation, Usage (HTML) isomath.sty literate source (the actual LaTeX package) isomath.sty.txt literate source (text version) @@ -35,7 +40,7 @@ isomath-test.pdf Test example (PDF output) The bidirectional text <-> code converter PyLit_ can convert between ``isomath.sty`` and ``isomath.sty.txt``. -The Python Docutils_ and pdflatex were used to generate the HTML and PDF +The Docutils_ and pdflatex were used to generate the HTML and PDF documentation from the reStructuredText_ sources. @@ -50,26 +55,33 @@ bold italic* fonts matching with Computer Modern and derivatives. All required packages are part of TeXLive and MikTeX. + Installation ============ -* Unpack isomath.zip (preferably in a TDS_ documentation folder). +If possible, get this package from your distribution using its installation +manager. + +Otherwise, make sure LaTeX can find the file `isomath.sty`: -* Make sure LaTeX can find isomath.sty: +* Download and unpack `isomath.zip` or just download `isomath.sty`. + +* Copy/Move/Link ``isomath.sty`` to a suitable place in the TDS_ and run + ``texhash``, or place it in the current working directory (e.g. for + testing). - Copy/Move/Link it to a suitable place in the TDS_ and run ``texhash`` - or place it in the current working directory (e.g. for testing). Usage ===== -:: +Load the package and (optionally) change the default ``\vec`` macro with:: \usepackage{isomath} + \renewcommand{\vec}{\vectorsym} % optional -Option description, more examples and usage hints are in the user -documentation. +Option description, more examples and usage hints are in the `user +documentation`_. .. References ========== @@ -84,3 +96,5 @@ documentation. .. _kvoptions: http://mirror.ctan.org/help/Catalogue/entries/kvoptions.html .. _TDS: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds + +.. _user documentation: isomath.sty.html diff --git a/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf b/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf Binary files differindex 07bc2bcc2c0..083afc40d1c 100644 --- a/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf +++ b/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf diff --git a/Master/texmf-dist/doc/latex/isomath/isomath-test.tex b/Master/texmf-dist/doc/latex/isomath/isomath-test.tex index b640a4ff66b..daed2193a50 100644 --- a/Master/texmf-dist/doc/latex/isomath/isomath-test.tex +++ b/Master/texmf-dist/doc/latex/isomath/isomath-test.tex @@ -1,4 +1,4 @@ -%isomath-test.tex: test and template for isomath.sty +% isomath-test.tex: test and template for isomath.sty % =================================================== % % Copyright © 2008 Günter Milde @@ -24,72 +24,70 @@ % (Auxiliary commands for package and option selection, so that the % selections can be shown in the test sheet.) % -% Uncomment the option(s) and package you want to test :: - -\newcommand*{\fontpackageoptions}{% -% default% with gfsneohellenic -% charter% with mathdesign -% garamond% with mathdesign -% utopia% with mathdesign -} - -\newcommand*{\fontpackage}{% -% ae,% \sfdefault is cmss -% anttor,% \sfdefault is cmss (use iwona) -% arev,% normal and sans identic (also in math) -% beton,% bitmap fonts -% concmath,% -% cmbright,% -% fourier,% incompatible (uses private font encoding) -% gfsneohellenic,% (use option [default]) no bold -% hfoldsty,% bitmap fonts -% iwona,% sets cmss as sans font (use iwona) -% kpfonts,% no sans serif italic -% kerkis,% no bold math, -% lmodern,% \sfdefault is cmss -% lucidabr,% commercial, subset (no math) free as bitmap -% lxfonts,% normal and sans identic, -% mathdesign,% \sfdefault is cmss, provides roman and roman-bold in OML -% mathptmx,% in mathnormal, Greek is larger than Latin! -% mbtimes,% \sfdefault is cmss -% mathpazo,% \sfdefault is cmss -% pxfonts,% needs reuseMathAlphabets, no sans-serif -tgcursor,% avoid bitmap tt -tgheros,% avoid bitmap sf -% tgpagella,% \sfdefault is cmss -tgtermes,% \sfdefault is cmss -% txfonts,% no sans-serif -% zefonts% +% Uncomment the package you want to test :: + +\newcommand*{\fontsetup}{\usepackage% +% {ae}% \sfdefault is cmss +% {anttor}% \sfdefault is cmss (use iwona) +% {arev}% normal and sans identic (also in math) +% {beton}% bitmap fonts +% {concmath}% +% {cmbright}% +% {fourier}% incompatible (uses private font encoding) +% [default]{gfsneohellenic}% no bold +% {hfoldsty}% bitmap fonts +% {iwona}% sets cmss as sans font (use iwona) +% [nomathscript]{kpfonts}% "Too many math alphabets" with OMLmathsfit option +% {kerkis}% no bold math, +% {lmodern}% \sfdefault is cmss +% {lucidabr}% commercial, subset (no math) free as bitmap +% {lxfonts}% normal and sans identic, +[utopia]{mathdesign}% \sfdefault is cmss, provides roman and roman-bold in OML +% [charter]{mathdesign}% +% [garamond]{mathdesign}% +% {mathptmx}% in mathnormal, Greek is larger than Latin! +% {mbtimes}% \sfdefault is cmss +% {mathpazo}% \sfdefault is cmss +% {newcent}% \sfdefault is cmss +% {pxfonts}% needs reuseMathAlphabets, no sans-serif +% {tgcursor}% avoid bitmap tt +% {tgheros}% avoid bitmap sf +% {tgpagella}% \sfdefault is cmss +% {tgtermes}% \sfdefault is cmss +% {txfonts}% no sans-serif } -% Isomath options -% ~~~~~~~~~~~~~~~ +% Isomath setup +% ~~~~~~~~~~~~~ % % Uncomment the option(s) you want to test :: -\newcommand*{\isomathoptions}{% +\newcommand*{\isomathsetup}{\usepackage[% % reuseMathAlphabets,% -% OMLmathrm,% -% OMLmathbf,% +OMLmathrm,% +OMLmathbf,% % OMLmathsf,% -OMLmathsfit,% +% OMLmathsfit,% % OMLmathtt,% % OMLmathsans,% backwards compatibility option alias +% rmdefault=zpple,% Mathpazo alternative % rmdefault=qtxmia,% TeX Gyre Termes math with alternative glyphs % sfdefault=cmbr,% default % sfdefault=iwona,% Iwona sans (Greek glyphs too close to roman) -% sfdefault=fav,% Arev sans (scale down (ca. 0.87)) +sfdefault=fav,% Arev sans (scale down (ca. 0.87)) +scaled=0.875% scaling for Arev (small letters) % sfdefault=llcmss,% LX sans (glyphs too close to italic, scale down) -% scaled=0.875% scaling for Arev (small letters) +% sfdefault=jkpss,% Kepler Sans +% scaled=0.95% scaling for Kepler Sans (small letters) +]{isomath}% } % Load customisable packages % -------------------------- % :: -\usepackage[\fontpackageoptions]{\fontpackage} -\usepackage[\isomathoptions]{isomath} - +\fontsetup +\isomathsetup % Auxiliary definitions % --------------------- @@ -101,7 +99,7 @@ OMLmathsfit,% % Fall-back definition for \mathsfit:: \providecommand*{\mathsfit}[1]% -{\textsf{mathsfit not defined, use \texttt{OMLmathsfit} option}} +{\emph{mathsfit not defined (requires \texttt{OMLmathsfit} option)}} % use Arev as "heavy" sans serif font:: @@ -118,10 +116,11 @@ OMLmathsfit,% \section*{Test the isomath Package} + % Print font package, isomath options, and resulting font families:: -Fontpackage: [\fontpackageoptions]\{\fontpackage\}\\ -Isomath: [\isomathoptions]\{isomath\}\\ +Font Setup: \detokenize\expandafter{\fontsetup}\\ +Isomath: \detokenize\expandafter{\isomathsetup}\\ Default font families: \makeatletter \begin{tabular}[t]{lrlrl} diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.html b/Master/texmf-dist/doc/latex/isomath/isomath.html index 3ed67206bc3..1d31f461d7c 100644 --- a/Master/texmf-dist/doc/latex/isomath/isomath.html +++ b/Master/texmf-dist/doc/latex/isomath/isomath.html @@ -3,16 +3,16 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.8: http://docutils.sourceforge.net/" /> -<title>isomath: Math for scientists</title> +<meta name="generator" content="Docutils 0.10: http://docutils.sourceforge.net/" /> +<title>isomath</title> <meta name="author" content="Günter Milde" /> -<meta name="date" content="2011-01-14" /> -<meta name="copyright" content="© 2008, 2011 Günter Milde" /> +<meta name="date" content="2012-09-04" /> +<meta name="copyright" content="© 2008, 2012 Günter Milde" /> <style type="text/css"> /* :Author: David Goodger (goodger@python.org) -:Id: $Id: html4css1.css 6511 2011-01-03 14:49:11Z milde $ +:Id: $Id: html4css1.css 7434 2012-05-11 21:06:27Z milde $ :Copyright: This stylesheet has been placed in the public domain. Default cascading style sheet for the HTML output of Docutils. @@ -252,10 +252,18 @@ pre.address { margin-top: 0 ; font: inherit } -pre.literal-block, pre.doctest-block { +pre.literal-block, pre.doctest-block, pre.math, pre.code { margin-left: 2em ; margin-right: 2em } +pre.code .ln { /* line numbers */ + color: grey; +} + +.code { + background-color: #eeeeee +} + span.classifier { font-family: sans-serif ; font-style: oblique } @@ -366,7 +374,7 @@ dl.simple, dl.compact, dl.simple > dd, dl.compact > dd { } /* space around paragraphs */ -dl > dd p:first-child { +dl > dd p:first-child, td > p { margin: 0; } @@ -506,9 +514,10 @@ resulting list resembles the list-style 'outside' with a hanging indent. */ /* New ordered list: reset counter, suppress the default label */ -ol { +ol, ol.arabic, ol.loweralpha, ol.upperalpha, +ol.lowerroman, ol.upperroman { counter-reset: item; - list-style-type: none ! important; + list-style: none } /* Set the negative indent of the list label as feature of the list item */ @@ -517,7 +526,7 @@ ol > li { } /* reset for child elements */ ol > li > * { - text-indent: 0px; + text-indent: 0px; text-indent: 0; margin-top: 0; /* background: lightgreen; */ @@ -566,6 +575,12 @@ ol.nested > li:before, ol.nested ol > li:before { content: counters(item, ".") " "; } +/* lists nested in definition list */ + +dd > ul, dd > ol { + padding-left: 0pt; +} + /* TODO: prefix, suffix? */ /* smaller font for super- and subscripts */ @@ -577,11 +592,14 @@ ol.nested > li:before, ol.nested ol > li:before { /* margins and borders for "normal" tables */ table { - margin-top: 0.5em ; - margin-bottom: 0.5em; - border-style: outset; +/* background: magenta; */ + margin-top: 1em ; + margin-bottom: 1em; +/* border-style: outset; */ + border-style: solid; + border-color: silver; border-width: thin; - /* border-collapse: collapse; */ + border-collapse: collapse; } blockquote > table { margin-top: 0em ; @@ -589,8 +607,9 @@ blockquote > table { } td, th { - border-style: inset; + border-style: solid; border-width: thin; + border-color: silver; /* text-align: left; */ padding: 0 1ex; } @@ -612,7 +631,6 @@ table.booktabs { border: 0; border-top: 2px solid; border-bottom: 2px solid; - border-collapse: collapse; } table.booktabs * { @@ -624,6 +642,7 @@ table.booktabs th { table > caption { text-align: left; + margin-bottom: 0.25em /* padding: 2em 0 1em 0; */ } @@ -744,24 +763,30 @@ td, th { padding-top: 0.1ex; } -/* no borders for "borderless" tables */ -table.booktabs.borderless, table.booktabs.borderless * { - border-style: none; -} +/* let borderless overreide booktab */ +.booktabs.borderless, +table.booktabs.borderless td, table.booktabs.borderless th { + border: 0; + margin-left: 2em; + } + +table.docutils td, table.docutils th, + vertical-align: bottom; } </style> </head> <body> -<div class="document" id="isomath-math-for-scientists"> -<h1 class="title">isomath: Math for scientists</h1> +<div class="document" id="isomath"> +<h1 class="title">isomath</h1> +<h2 class="subtitle" id="mathematical-style-for-science-and-technology">Mathematical style for science and technology</h2> <dl class="docinfo simple"> <dt class="author">Author</dt> <dd class="author">Günter Milde</dd> <dt class="date">Date</dt> -<dd class="date">2011-01-14</dd> +<dd class="date">2012-09-04</dd> <dt class="copyright">Copyright</dt> -<dd class="copyright">© 2008, 2011 Günter Milde</dd> +<dd class="copyright">© 2008, 2012 Günter Milde</dd> <dt>Licence</dt> <dd><p>This work may be distributed and/or modified under the conditions of the <a class="reference external" href="http://www.latex-project.org/lppl.txt">LaTeX Project Public License</a>, either @@ -770,39 +795,29 @@ version 1.3 of this license or (at your option) any later version.</p> </dl> <div class="abstract topic"> <p class="topic-title first">Abstract</p> -<p>The <cite>isomath</cite> package sets up an “ISO math style” allowing the -use of Greek and Latin letters as symbols for scalars, -vectors, matrices, and tensors in the typefaces recommended -for scientific papers by the International Standard -ISO 80000-2.</p> +<p>The <cite>isomath</cite> package provides tools for a mathematical style +that conforms to the International Standard ISO 80000-2 and is +common in science and technology. It changes the default shape of +capital Greek letters to italic, sets up bold italic and +sans-serif bold italic math alphabets with Latin and Greek +characters, and defines macros for markup of vector, matrix and +tensor symbols.</p> </div> <!-- -*- rst-mode -*- --> <div class="contents topic" id="contents"> <p class="topic-title first">Contents</p> <ul class="auto-toc simple"> -<li><p><a class="reference internal" href="#features" id="id30"><span class="sectnum">1</span> Features</a></p> -<ul class="auto-toc"> -<li><p><a class="reference internal" href="#iso-math-style" id="id31"><span class="sectnum">1.1</span> ISO math style</a></p></li> -<li><p><a class="reference internal" href="#new-math-alphabets" id="id32"><span class="sectnum">1.2</span> New math alphabets</a></p></li> -<li><p><a class="reference internal" href="#semantic-markup" id="id33"><span class="sectnum">1.3</span> Semantic markup</a></p></li> -</ul> -</li> -<li><p><a class="reference internal" href="#usage" id="id34"><span class="sectnum">2</span> Usage</a></p> -<ul class="auto-toc"> -<li><p><a class="reference internal" href="#options" id="id35"><span class="sectnum">2.1</span> Options</a></p> +<li><p><a class="reference internal" href="#features" id="id36"><span class="sectnum">1</span> Features</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#rmdefault" id="id36"><span class="sectnum">2.1.1</span> rmdefault</a></p></li> -<li><p><a class="reference internal" href="#sfdefault" id="id37"><span class="sectnum">2.1.2</span> sfdefault</a></p></li> -<li><p><a class="reference internal" href="#scaled" id="id38"><span class="sectnum">2.1.3</span> scaled</a></p></li> -<li><p><a class="reference internal" href="#reusemathalphabets" id="id39"><span class="sectnum">2.1.4</span> reuseMathAlphabets</a></p></li> -<li><p><a class="reference internal" href="#omlmathrm-omlmathbf-omlmathsf-omlmathsfit-omlmathtt" id="id40"><span class="sectnum">2.1.5</span> OMLmathrm, OMLmathbf, OMLmathsf, OMLmathsfit, OMLmathtt</a></p></li> +<li><p><a class="reference internal" href="#iso-math-style" id="id37"><span class="sectnum">1.1</span> “ISO” math style</a></p></li> +<li><p><a class="reference internal" href="#new-math-alphabets" id="id38"><span class="sectnum">1.2</span> New math alphabets</a></p></li> +<li><p><a class="reference internal" href="#semantic-markup" id="id39"><span class="sectnum">1.3</span> Semantic markup</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#examples" id="id41"><span class="sectnum">2.2</span> Examples</a></p> +<li><p><a class="reference internal" href="#usage" id="id40"><span class="sectnum">2</span> Usage</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#how-to-get-upright-small-greek-letters" id="id42"><span class="sectnum">2.2.1</span> How to get upright small Greek letters</a></p></li> -</ul> -</li> +<li><p><a class="reference internal" href="#options" id="id41"><span class="sectnum">2.1</span> Options</a></p></li> +<li><p><a class="reference internal" href="#examples" id="id42"><span class="sectnum">2.2</span> Examples</a></p></li> </ul> </li> <li><p><a class="reference internal" href="#related-packages" id="id43"><span class="sectnum">3</span> Related packages</a></p> @@ -815,106 +830,81 @@ ISO 80000-2.</p> </li> <li><p><a class="reference internal" href="#background" id="id48"><span class="sectnum">4</span> Background</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#math-font-selection" id="id49"><span class="sectnum">4.1</span> Math font selection</a></p> -<ul class="auto-toc"> -<li><p><a class="reference internal" href="#math-alphabets" id="id50"><span class="sectnum">4.1.1</span> Math alphabets</a></p></li> -<li><p><a class="reference internal" href="#math-versions" id="id51"><span class="sectnum">4.1.2</span> Math versions</a></p></li> -<li><p><a class="reference internal" href="#math-styles" id="id52"><span class="sectnum">4.1.3</span> Math styles</a></p></li> -</ul> -</li> -<li><p><a class="reference internal" href="#math-letter-fonts" id="id53"><span class="sectnum">4.2</span> Math letter fonts</a></p> -<ul class="auto-toc"> -<li><p><a class="reference internal" href="#oml-font-encoding" id="id54"><span class="sectnum">4.2.1</span> OML font encoding</a></p></li> -<li><p><a class="reference internal" href="#oml-support" id="id55"><span class="sectnum">4.2.2</span> OML Support</a></p></li> +<li><p><a class="reference internal" href="#math-font-selection" id="id49"><span class="sectnum">4.1</span> Math font selection</a></p></li> +<li><p><a class="reference internal" href="#oml-font-encoding" id="id50"><span class="sectnum">4.2</span> OML font encoding</a></p></li> +<li><p><a class="reference internal" href="#unicode-mathematical-typesetting" id="id51"><span class="sectnum">4.3</span> Unicode mathematical typesetting</a></p></li> +<li><p><a class="reference internal" href="#conclusions-and-outlook" id="id52"><span class="sectnum">4.4</span> Conclusions and outlook</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#unicode-mathematical-typesetting" id="id56"><span class="sectnum">4.3</span> Unicode mathematical typesetting</a></p> -<ul class="auto-toc"> -<li><p><a class="reference internal" href="#unicode-math-alphabets" id="id57"><span class="sectnum">4.3.1</span> Unicode math alphabets</a></p> -<ul class="auto-toc"> -<li><p><a class="reference internal" href="#naming-scheme" id="id58"><span class="sectnum">4.3.1.1</span> Naming scheme</a></p></li> -</ul> -</li> -<li><p><a class="reference internal" href="#the-unicode-math-package" id="id59"><span class="sectnum">4.3.2</span> The unicode-math package</a></p></li> -</ul> -</li> -<li><p><a class="reference internal" href="#conclusions-and-outlook" id="id60"><span class="sectnum">4.4</span> Conclusions and outlook</a></p></li> -</ul> -</li> -<li><p><a class="reference internal" href="#references" id="id61"><span class="sectnum">5</span> References</a></p></li> +<li><p><a class="reference internal" href="#references" id="id53"><span class="sectnum">5</span> References</a></p></li> </ul> </div> <div class="section" id="features"> -<h1><a class="toc-backref" href="#id30"><span class="sectnum">1</span> Features</a></h1> +<h1><a class="toc-backref" href="#id36"><span class="sectnum">1</span> Features</a></h1> <!-- How do you write the stress tensor ``$\sigma$`` in a -`sans-serif bold italic` typeface, as recommended by [typefaces]_? --> -<p>Leading international scientific organisations recommend math layout -rules in line with the International Standard <a class="citation-reference" href="#iso-80000-2" id="id1">[ISO-80000-2]</a> in their -style guides, e. g., <a class="citation-reference" href="#typefaces" id="id2">[typefaces]</a>, <a class="citation-reference" href="#checklist" id="id3">[checklist]</a>, <a class="citation-reference" href="#si" id="id4">[SI]</a>, <a class="citation-reference" href="#fonts-for-symbols" id="id5">[fonts_for_symbols]</a>, -<a class="citation-reference" href="#red-book" id="id6">[Red-Book]</a>, <a class="citation-reference" href="#green-book" id="id7">[Green-Book]</a>:</p> +*sans-serif bold italic* typeface, as recommended by [typefaces]_? --> +<p>In their style guides, e. g. <a class="citation-reference" href="#typefaces" id="id1">[typefaces]</a>, <a class="citation-reference" href="#checklist" id="id2">[checklist]</a>, <a class="citation-reference" href="#si" id="id3">[SI]</a>, +<a class="citation-reference" href="#fonts-for-symbols" id="id4">[fonts_for_symbols]</a>, <a class="citation-reference" href="#red-book" id="id5">[Red-Book]</a>, <a class="citation-reference" href="#green-book" id="id6">[Green-Book]</a>, many international +scientific organisations recommend layout rules for mathematics in line with +the International Standard <a class="citation-reference" href="#iso-80000-2" id="id7">[ISO-80000-2]</a>.</p> +<div class="admonition-international-standard-layout-rules admonition"> +<p class="admonition-title">International standard layout rules</p> <ul class="simple"> <li><p>The overall rule is that symbols representing physical quantities (or variables) are italic, but symbols representing units, or labels, are roman.</p></li> -<li><p>Symbols for vectors are boldface italic, symbols for tensors are -sans-serif bold italic, and symbols for matrices are boldface -italic.</p></li> -<li><p>The above rules apply equally to letter symbols from both the Greek -and the Latin alphabet.</p></li> +<li><p>Symbols for vectors and matrices are bold italic, symbols for tensors +are sans-serif bold italic.</p></li> +<li><p>The above rules apply equally to letter symbols from the Greek and the +Latin alphabet.</p></li> </ul> -<p>The traditional TeX <a class="reference internal" href="#math-style">math style</a> deviates from this rules in some +</div> +<!-- The recommendations in this standard are intended mainly for use in the +natural sciences and technology, but also apply to other areas where +mathematics is used. --> +<p>TeX's default mathematical style deviates from this rules in several points:</p> <ul class="simple"> -<li><p>capital Greek letters default to upright shape,</p></li> -<li><p>small Greek letters are excluded from font changes with the <a class="reference internal" href="#math-alphabets">math -alphabets</a>.</p></li> -<li><p>The <tt class="literal">\vec</tt> command produces an arrow accent.</p></li> +<li><p>Capital Greek letters default to upright shape,</p></li> +<li><p>small Greek letters are excluded from font changes with the <a class="reference internal" href="#math-alphabet">math +alphabet</a> commands, and</p></li> +<li><p>the <tt class="literal">\vec</tt> command produces an arrow accent.</p></li> </ul> -<p>The <cite>isomath</cite> package implements an <a class="reference internal" href="#iso-math-style">ISO math style</a> and provides -<a class="reference internal" href="#new-math-alphabets">new math alphabets</a> with bold italic and sans-serif bold italic -typeshape that can be used for vector and tensor symbols.</p> +<p>The <cite>isomath</cite> package implements an <a class="reference internal" href="#iso-math-style">“ISO” math style</a>, provides <a class="reference internal" href="#new-math-alphabets">new math +alphabets</a> with <em>bold italic</em> and <em>sans-serif bold italic</em> type and macros +for <a class="reference internal" href="#semantic-markup">semantic markup</a> of vector, matrix and tensor symbols. It can be +combined with most packages for mathematical typesetting (see +<a class="reference external" href="isomath-test.tex">isomath-test.tex</a> and the sections on <a class="reference internal" href="#alternatives">alternatives</a> and <a class="reference internal" href="#conflicts">conflicts</a>).</p> <div class="section" id="iso-math-style"> -<span id="equal-treatment-of-latin-and-greek"></span><h2><a class="toc-backref" href="#id31"><span class="sectnum">1.1</span> ISO math style</a></h2> -<p>The required package <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixmath.html">fixmath</a> changes the default math layout to the -“ISO” <a class="reference internal" href="#math-style">math style</a>:</p> +<h2><a class="toc-backref" href="#id37"><span class="sectnum">1.1</span> “ISO” math style</a></h2> +<p>Isomath builds on the package <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixmath.html">fixmath</a> by Walter Schmidt to change the +default mathematics layout to the “ISO” <a class="reference internal" href="#math-style">math style</a>:</p> <ul class="simple"> -<li><p>Uppercase Greek letters are typeset italic by default.</p></li> +<li><p>Capital Greek letters are typeset in italic shape by default.</p></li> <li><p>Both, Greek and Latin letters change shape if a different <a class="reference internal" href="#math-alphabet">math alphabet</a> is used.</p></li> </ul> -<p>However, fixmath works only for the Computer Modern font family. -With <cite>isomath</cite>,</p> -<ul class="simple"> -<li><p>the used math fonts are configurable (using the <a class="reference internal" href="#rmdefault">rmdefault</a> and -<a class="reference internal" href="#sfdefault">sfdefault</a> options), and</p></li> -<li><p>upright Greek letters can be made available through the common -<tt class="literal">\math*</tt> alphabets via the <a class="reference internal" href="#omlmath">OMLmath*</a> options if the -corresponding fonts support the <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>.</p></li> -</ul> <div class="caution"> <p class="admonition-title">Caution!</p> -<p>Using Greek letters in standard <a class="reference internal" href="#math-alphabets">math alphabets</a>, e. g., -<tt class="literal"><span class="pre">\mathrm{\pi}</span></tt>, can lead to garbage, as the standard math -alphabets are usually taken from text fonts that have ligatures and -non-alpha symbols in place of the small Greek letters. -Do not use small Greek letters in the standard math alphabet commands -<tt class="literal">mathit</tt>, <tt class="literal">mathrm</tt>, <tt class="literal">mathbf</tt>, <tt class="literal">mathsf</tt>, and <tt class="literal">mathtt</tt> -unless you use the <a class="reference internal" href="#omlmath">OMLmath*</a> options.</p> -<p>Some packages provide alternative macros or options for upright -Greek letters (cf. <a class="reference internal" href="#table-6">Table 6</a>).</p> +<p>Be careful with Greek letters in the argument of <tt class="literal">\mathit</tt>, <tt class="literal">\mathrm</tt>, +<tt class="literal">\mathbf</tt>, <tt class="literal">\mathsf</tt>, and <tt class="literal">\mathtt</tt>. By default, these <a class="reference internal" href="#math-alphabets">math +alphabets</a> use text fonts. Fonts in OT1 text font encoding have capital +(but not small) Greek letters at the expected places, T1 encoded text fonts +have no Greek letters at all.</p> +<p>See the <a class="reference internal" href="#examples">examples</a> section on <a class="reference internal" href="#how-to-get-upright-small-greek-letters">how to get upright small Greek letters</a> in +mathematical context.</p> </div> </div> <div class="section" id="new-math-alphabets"> -<h2><a class="toc-backref" href="#id32"><span class="sectnum">1.2</span> New math alphabets</a></h2> -<p><cite>Isomath</cite> defines three new <a class="reference internal" href="#math-alphabets">math alphabets</a>:</p> -<blockquote> +<h2><a class="toc-backref" href="#id38"><span class="sectnum">1.2</span> New math alphabets</a></h2> +<p><cite>Isomath</cite> defines the new <a class="reference internal" href="#math-alphabets">math alphabets</a>:</p> <table class="borderless booktabs numbered align-left"> <colgroup> <col width="21%" /> <col width="31%" /> <col width="47%" /> </colgroup> -<tbody valign="top"> +<tbody> <tr><td><p><tt class="literal">\mathbfit</tt></p></td> <td><p>boldface italic</p></td> <td><p>vector and matrix symbols</p></td> @@ -929,30 +919,27 @@ Greek letters (cf. <a class="reference internal" href="#table-6">Table  </tr> </tbody> </table> -</blockquote> +<p>For compatibility with earlier versions and <a class="reference internal" href="#related-packages">related packages</a>, the +new math alphabets are also available under the aliases +<tt class="literal">\mathbold</tt>, <tt class="literal">\mathsans</tt>, and <tt class="literal">\mathboldsans</tt>.</p> <p>The <a class="reference internal" href="#rmdefault">rmdefault</a> and <a class="reference internal" href="#sfdefault">sfdefault</a> <a class="reference internal" href="#options">options</a> set the font family used for these alphabets.</p> <div class="caution"> <p class="admonition-title">Caution!</p> -<p>Using the new math alphabets for numbers can result in <span class="target" id="upright-old-style-numbers">upright -old-style numbers</span> instead of italic ones, because some italic math -fonts (e. g., cmr, cmbr) have old-style numbers in place of italic -digits.</p> +<p>Using the new math alphabets for numbers can result in upright old-style +numbers instead of italic ones, because some italic math fonts (e. g., +<tt class="literal">cmr</tt>, <tt class="literal">cmbr</tt>) contain old-style in place of italic digits.</p> </div> -<p>For compatibility with earlier versions and <a class="reference internal" href="#related-packages">related packages</a>, the -new math alphabets are also available under the aliases -<tt class="literal">\mathbold</tt>, <tt class="literal">\mathsans</tt>, and <tt class="literal">\mathboldsans</tt>.</p> </div> <div class="section" id="semantic-markup"> -<h2><a class="toc-backref" href="#id33"><span class="sectnum">1.3</span> Semantic markup</a></h2> -<p>The following commands set the argument in an ISO-conforming math alphabet:</p> -<blockquote> +<h2><a class="toc-backref" href="#id39"><span class="sectnum">1.3</span> Semantic markup</a></h2> +<p>The following commands set the argument in an ISO-conforming <a class="reference internal" href="#math-alphabet">math alphabet</a>:</p> <table class="borderless booktabs numbered align-left"> <colgroup> <col width="39%" /> <col width="61%" /> </colgroup> -<tbody valign="top"> +<tbody> <tr><td><p><tt class="literal">\vectorsym, \matrixsym</tt></p></td> <td><p>bold italic for Greek and Latin letters, bold upright for numbers</p></td> @@ -962,25 +949,29 @@ bold upright for numbers</p></td> </tr> </tbody> </table> -</blockquote> </div> </div> <div class="section" id="usage"> -<h1><a class="toc-backref" href="#id34"><span class="sectnum">2</span> Usage</a></h1> -<p>Make sure that LaTeX can find <tt class="literal">isomath.sty</tt> and load it with -<tt class="literal">\usepackage</tt> (see also <a class="reference internal" href="#options">Options</a> and <a class="reference internal" href="#examples">Examples</a>).</p> +<h1><a class="toc-backref" href="#id40"><span class="sectnum">2</span> Usage</a></h1> +<p>Make sure that LaTeX can find <tt class="literal">isomath.sty</tt> and load it with:</p> +<pre class="literal-block">\usepackage{isomath} +</pre> +<p>Optionally redefine the standard vector macro <tt class="literal">\vec</tt>:</p> +<pre class="literal-block">\renewcommand{\vec}{\vectorsym} +</pre> +<p>(see also <a class="reference internal" href="#options">Options</a>, <a class="reference internal" href="#examples">Examples</a>, and <a class="reference external" href="isomath-test.tex">isomath-test.tex</a>).</p> <div class="section" id="options"> -<h2><a class="toc-backref" href="#id35"><span class="sectnum">2.1</span> Options</a></h2> +<h2><a class="toc-backref" href="#id41"><span class="sectnum">2.1</span> Options</a></h2> <div class="section" id="rmdefault"> -<h3><a class="toc-backref" href="#id36"><span class="sectnum">2.1.1</span> rmdefault</a></h3> +<h3><span class="sectnum">2.1.1</span> rmdefault</h3> <p>Family for serif math fonts (<tt class="literal">\mathrm</tt>, <tt class="literal">\mathbf</tt>, <tt class="literal">\mathit</tt>, <tt class="literal">\mathbfit</tt>). The default is to use the corresponding text font family (the value of <tt class="literal">\rmdefault</tt>). The font must be available in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a> (cf. <a class="reference internal" href="#table-3">Table 3</a>).</p> </div> <div class="section" id="sfdefault"> -<h3><a class="toc-backref" href="#id37"><span class="sectnum">2.1.2</span> sfdefault</a></h3> -<p>Family for sans-serif math fonts. The default is <tt class="literal">cmbr</tt> because many +<h3><span class="sectnum">2.1.2</span> sfdefault</h3> +<p>Family for sans-serif math fonts. The default is <tt class="literal">cmbr</tt> because most sans-serif fonts define the Computer Roman font <cite>cmm</cite> as OML substitution (see <a class="reference internal" href="#table-4">Table 4</a>).</p> <p>There are only few sans serif fonts in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>:</p> @@ -988,7 +979,7 @@ sans-serif fonts define the Computer Roman font <cite>cmm</cite> as OML substitu <colgroup> <col width="14%" /> <col width="15%" /> -<col width="71%" /> +<col width="72%" /> </colgroup> <thead valign="bottom"> <tr><th class="head"><p>Name</p></th> @@ -996,7 +987,7 @@ sans-serif fonts define the Computer Roman font <cite>cmm</cite> as OML substitu <th class="head"><p>Comment</p></th> </tr> </thead> -<tbody valign="top"> +<tbody> <tr><td><p><tt class="literal">cmbr</tt></p></td> <td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/cmbright.html">cmbright</a></p></td> <td><p><cite>Computer Modern Bright</cite>, bitmap, slightly lighter @@ -1004,34 +995,36 @@ than cmss (Type 1 fonts with <a class="reference external" href="http://mirror.c </tr> <tr><td><p><tt class="literal">fav</tt></p></td> <td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/arev.html">arev</a></p></td> -<td><p><cite>Arev</cite> (<cite>Vera Sans</cite>) with math extension, -large x-height</p></td> +<td><p><cite>Arev</cite> (<cite>Vera Sans</cite>), large x-height</p></td> +</tr> +<tr><td><p><tt class="literal">hvm</tt></p></td> +<td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/hvmath.html">hvmath</a></p></td> +<td><p><cite>Helvetica Math</cite>, commercial, free bitmap version</p></td> </tr> <tr><td><p><tt class="literal">iwona</tt></p></td> <td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/iwona.html">iwona</a></p></td> -<td><p>Humanistic Sans Serif, +<td><p><cite>Iwona</cite>, humanistic sans serif, some shapes very similar to roman</p></td> </tr> -<tr><td><p><tt class="literal">hvm</tt></p></td> -<td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/hvmath.html">hvmath</a></p></td> -<td><p><cite>Helvetica Math</cite>, commercial, free bitmap version</p></td> +<tr><td><p><tt class="literal">jkpss</tt></p></td> +<td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kpfonts.html">kpfonts</a></p></td> +<td><p><cite>Kepler Sans</cite>, quite light</p></td> </tr> <tr><td><p><tt class="literal">llcmss</tt></p></td> <td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/lxfonts.html">lxfonts</a></p></td> -<td><p><cite>LX Fonts</cite>, very wide, eccentric, large x-height, -new in 2008</p></td> +<td><p><cite>LX Fonts</cite>, “slide fonts”, very wide, large x-height</p></td> </tr> </tbody> </table> </div> <div class="section" id="scaled"> -<h3><a class="toc-backref" href="#id38"><span class="sectnum">2.1.3</span> scaled</a></h3> -<p>To improve the chances of configuring a matching sans serif math font, -the fonts, <tt class="literal">fav</tt>, <tt class="literal">llcmss</tt>, and <tt class="literal">iwona</tt> can be scaled with the -<tt class="literal">scaled</tt> option (cf. <a class="reference internal" href="#examples">Examples</a>).</p> +<h3><span class="sectnum">2.1.3</span> scaled</h3> +<p>To improve the chances of finding a matching sans serif math font, the +fonts <tt class="literal">fav</tt>, <tt class="literal">iwona</tt>, <tt class="literal">jkpss</tt>, and <tt class="literal">llcmss</tt> can be scaled with the +<tt class="literal">scaled</tt> option (cf. <a class="reference internal" href="#examples">Examples</a>). For other fonts, the option is ignored.</p> </div> <div class="section" id="reusemathalphabets"> -<h3><a class="toc-backref" href="#id39"><span class="sectnum">2.1.4</span> reuseMathAlphabets</a></h3> +<h3><span class="sectnum">2.1.4</span> reuseMathAlphabets</h3> <p>The definition of new math alphabets can lead to a “<a class="reference internal" href="#too-many-math-alphabets-used-in-version-normal">too many math alphabets used in version normal</a>” error. As a workaround, this option tells <cite>isomath</cite> to re-use the existing <tt class="literal">\mathbf</tt> and @@ -1039,46 +1032,40 @@ option tells <cite>isomath</cite> to re-use the existing <tt class="literal">\ma <dl class="footnote"><dt class="label"><a class="fn-backref" href="#id8">1</a></dt> <dd id="id9"> <p class="first last">To access the upright shapes, the corresponding <tt class="literal">\textbf</tt> and -<tt class="literal">\textsf</tt> commands might be used. However, this toggles the -math-mode off and might use a different font, so watch for -side-effects.</p> +<tt class="literal">\textsf</tt> commands might be used. Watch for side-effects, as these +commands switch to text mode so that the font settings in the embedding +text apply.</p> </dd> </dl> </div> <div class="section" id="omlmathrm-omlmathbf-omlmathsf-omlmathsfit-omlmathtt"> -<span id="omlmath"></span><h3><a class="toc-backref" href="#id40"><span class="sectnum">2.1.5</span> OMLmathrm, OMLmathbf, OMLmathsf, OMLmathsfit, OMLmathtt</a></h3> -<p>With Greek letters defined as <tt class="literal">\mathalpha</tt>, the letter fonts are -expected to be in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>. The predefined -<a class="reference internal" href="#math-alphabets">math alphabets</a>, however, use OT1 encoded text fonts. These fonts -have ligatures and accents in place of the small Greek letters. -The <tt class="literal">\mathsfit</tt> alphabet is not required for ISO conforming math.</p> +<span id="omlmath"></span><h3><span class="sectnum">2.1.5</span> OMLmathrm, OMLmathbf, OMLmathsf, OMLmathsfit, OMLmathtt</h3> <p>The <tt class="literal">OMLmath*</tt> options bind the corresponding <tt class="literal">\math*</tt> command to an -OML-encoded font. -This enables use of small Greek letters in <a class="reference internal" href="#math-alphabet">math alphabet</a> commands, -e. g., <tt class="literal"><span class="pre">\mathrm{\pi}</span></tt> <em>if an OML encoded font is available</em>. -<a class="reference internal" href="#table-3">Table 3</a> lists font families supporting the OML encoding.</p> +OML-encoded font.</p> +<p>The <tt class="literal">\mathsfit</tt> alphabet is not required for ISO conforming mathematical +layout and therefore only defined if the <tt class="literal">OMLmathsfit</tt> argument is used.</p> +<p>The predefined <a class="reference internal" href="#math-alphabets">math alphabets</a> <tt class="literal">\mathrm</tt>, <tt class="literal">\mathbf</tt>, and <tt class="literal">\mathtt</tt> +use OT1 encoded text fonts with ligatures and accents in place of the small +Greek letters. The <tt class="literal">OMLmath*</tt> options enable the use of small Greek +letters in <a class="reference internal" href="#math-alphabet">math alphabet</a> commands, e. g. <tt class="literal"><span class="pre">\mathrm{\pi}</span></tt>, if the +corresponding font is available in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>. <a class="reference internal" href="#table-3">Table 3</a> lists +font families supporting the OML encoding.</p> <div class="caution"> <p class="admonition-title">Caution!</p> -<p>If no matching OML encoded font is found, LaTeX's substitute -mechanism kicks in and selects a font with different font attributes -(for all letters, not only Greek). Currently, only the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html">mathdesign</a> -package provides upright fonts in OML encoding. Many font packages -define an <em>italic</em> font as OML substitute for roman fonts.</p> +<p>If no matching OML encoded font is found, LaTeX's substitute mechanism +selects a font with different font attributes (for all letters, not only +Greek). Currently, only the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html">mathdesign</a> package provides upright fonts in +OML encoding. Many font packages define an <em>italic</em> font as OML substitute +for roman fonts.</p> <p>With some packages, these options can result in a “<a class="reference internal" href="#too-many-math-alphabets-used-in-version-normal">too many math alphabets used in version normal</a>” error.</p> </div> </div> </div> <div class="section" id="examples"> -<h2><a class="toc-backref" href="#id41"><span class="sectnum">2.2</span> Examples</a></h2> +<h2><a class="toc-backref" href="#id42"><span class="sectnum">2.2</span> Examples</a></h2> <ul> -<li><p>Redefine the standard <tt class="literal">\vec</tt> command to set its argument in an -ISO-conforming math alphabet.:</p> -<pre class="literal-block">\usepackage{isomath} -\renewcommand{\vec}{\vectorsym} -</pre> -</li> -<li><p>Use scaled <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/arev.html">arev</a> fonts for the sans serif alphabets +<li><p>Use scaled <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/arev.html">arev</a> fonts for the sans serif math alphabets (adapt the scaling factor to your needs):</p> <pre class="literal-block">\usepackage[sfdefault=fav,scaled=0.875]{isomath} </pre> @@ -1098,9 +1085,9 @@ bold version of <tt class="literal">\mathsfbfit</tt>:</p> </pre> </li> </ul> -<p>See also the <tt class="literal"><span class="pre">isomath-test.tex</span></tt> test document.</p> +<p>See also the <a class="reference external" href="isomath-test.tex">isomath-test.tex</a> test document.</p> <div class="section" id="how-to-get-upright-small-greek-letters"> -<h3><a class="toc-backref" href="#id42"><span class="sectnum">2.2.1</span> How to get upright small Greek letters</a></h3> +<h3><span class="sectnum">2.2.1</span> How to get upright small Greek letters</h3> <p>Of the following methods, only the first requires <cite>isomath</cite>:</p> <ol class="loweralpha"> <li><p>Use <cite>isomath</cite> and the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html">mathdesign</a> package:</p> @@ -1118,14 +1105,13 @@ fonts, e. g.:</p> <p>(check if the letter shapes match with the rest of the document).</p> </li> <li><p>Use a package that provides macros for upright Greek letters -in math:</p> -<blockquote> +in math mode:</p> <table class="borderless booktabs numbered align-left"> <colgroup> <col width="26%" /> <col width="74%" /> </colgroup> -<tbody valign="top"> +<tbody> <tr><td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fourier.html">fourier</a></p></td> <td><p><tt class="literal">\otheralpha ... \otherOmega</tt></p></td> </tr> @@ -1140,7 +1126,6 @@ in math:</p> </tr> </tbody> </table> -</blockquote> </li> <li><p>Use an upright text character (requires a matching LGR-encoded Greek text font). The following lines redefine <tt class="literal">\pi</tt> to set @@ -1152,6 +1137,15 @@ the mathematical constant pi upright:</p> \renewcommand{\pi}{\text{\textrm{\greektext p }}} </pre> </li> +<li><p>Use the text character with the <cite>alphabeta</cite> package from the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/lgrx.html">lgrx</a> +bundle:</p> +<pre class="literal-block">\usepackage{amsmath} +\usepackage{alphabeta} +</pre> +<p>and in the body</p> +<pre class="literal-block">$ u = 2 \text{\pi} r $ +</pre> +</li> </ol> </div> </div> @@ -1191,30 +1185,32 @@ letters will not match in size.</p> </div> <div class="section" id="alternatives"> <h2><a class="toc-backref" href="#id46"><span class="sectnum">3.3</span> Alternatives</a></h2> -<p>See <a class="reference internal" href="#table-2">Table 2</a> for other packages that implement the “ISO” <a class="reference internal" href="#math-style">math -style</a> and <a class="reference internal" href="#table-6">Table 6</a> for packages that provide bold italic -math fonts.</p> +<p>The TUGboat article by Claudio Beccari <a class="citation-reference" href="#becc97" id="id10">[becc97]</a> discusses tricks and +commands for physicists and engineers in order to satisfy the international +regulations and to distinguish similar symbols with different meanings.</p> +<p>See <a class="reference internal" href="#table-2">Table 2</a> for other packages that implement the “ISO” <a class="reference internal" href="#math-style">math style</a> and +<a class="reference internal" href="#table-6">Table 6</a> for packages that provide bold italic math fonts.</p> <dl class="docutils"> <dt><a class="reference internal" href="#in-line-math-versions">“In-line math versions”</a></dt> <dd><p>can be used as ISO-conforming replacement for <tt class="literal">\vec</tt>:</p> <ul class="simple"> +<li><p><tt class="literal">\bm</tt> from the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/bm.html">bm</a> package. Combining <cite>bm</cite> and <cite>isomath</cite> may +lead to the <a class="reference internal" href="#too-many-math-alphabets-used-in-version-normal">too many math alphabets used in version normal</a> error.</p></li> <li><p><tt class="literal">\boldsymbol</tt> from <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/amsbsy.html">amsbsy</a> (part of <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/amsmath.html">amsmath</a>, the near-indispensable adjunct to serious mathematical typesetting in LaTeX),</p></li> -<li><p><tt class="literal">\bm</tt> from the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/bm.html">bm</a> package. Combining <cite>bm</cite> and <cite>isomath</cite> may -lead to the <a class="reference internal" href="#too-many-math-alphabets-used-in-version-normal">too many math alphabets used in version normal</a> error.</p></li> </ul> </dd> -<dt><tt class="literal">\text</tt></dt> -<dd><p>from <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/amsmath.html">amsmath</a> can be used to get, e. g., upright or sans-serif -bold italic Greek symbols from a text font into a formula (see +<dt><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/amsmath.html">amsmath</a></dt> +<dd><p>provides the command <tt class="literal">\text</tt>, that can be used to get, e. g., upright or +sans-serif bold italic Greek symbols from a text font into a formula (see <a class="reference internal" href="#how-to-get-upright-small-greek-letters">How to get upright small Greek letters</a>).</p> </dd> <dt><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/unicode-math.html">unicode-math</a></dt> <dd><p>for XeTeX and LuaTeX allows mathematical typesetting using OpenType math fonts. It supports the “ISO” <a class="reference internal" href="#math-style">math style</a> and all mathematical characters in the Unicode standard.</p> -<p>unicode-math cannot be used together with <cite>isomath</cite>. It can, however, +<p><cite>unicode-math</cite> cannot be used together with <cite>isomath</cite>. It can, however, replace all of isomath's functionality. See the discussion of <a class="reference internal" href="#the-unicode-math-package">the unicode-math package</a> below.</p> </dd> @@ -1231,9 +1227,10 @@ than 16 fonts into the <tt class="literal">normal</tt> <a class="reference inter <p>Examples for problematic combinations:</p> <ul class="simple"> <li><p>The <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kpfonts.html">kpfonts</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/pxfonts.html">pxfonts</a>, and <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/txfonts.html">txfonts</a> packages define many -additional math alphabets.</p></li> +additional math alphabets (<cite>kpfonts</cite> works with <cite>isomath</cite>, if +it is loaded with <tt class="literal"><span class="pre">\usepackage[nomathscript]{kpfonts}</span></tt>).</p></li> <li><p>The <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/bm.html">bm</a> package normally allocates several symbol fonts for bold -and heavy fonts. Their number can be customized by defining +and heavy fonts. Their number can be customised by defining <tt class="literal">\bmmax</tt> and <tt class="literal">\hmmax</tt> before loading the package.</p></li> </ul> </dd> @@ -1248,26 +1245,32 @@ math font encodings. It cannot be used with <cite>isomath</cite>.</p> sfdefault=arev,scaled=0.85]{isomath} </pre> </dd> +<dt><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/sansmath.html">sansmath</a></dt> +<dd><p>defines a <cite>sans</cite> <a class="reference internal" href="#math-version">math version</a> using <strong>text</strong> fonts in OT1 or T1 font +encoding. As fixmath/isomath expect math fonts in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>, +Greek letters will not work inside the sans math version defined by +sansmath.</p> +</dd> </dl> </div> </div> <div class="section" id="background"> <h1><a class="toc-backref" href="#id48"><span class="sectnum">4</span> Background</a></h1> -<p>This section discusses LaTeX <a class="reference internal" href="#math-font-selection">math font selection</a>, suitable -<a class="reference internal" href="#math-letter-fonts">math letter fonts</a> for the ISO math style, and the relation of LaTeX and -<a class="reference internal" href="#unicode-mathematical-typesetting">Unicode mathematical typesetting</a>.</p> +<p>This section discusses LaTeX <a class="reference internal" href="#math-font-selection">math font selection</a>, the <a class="reference internal" href="#oml-font-encoding">OML font +encoding</a>, and the relation of LaTeX and <a class="reference internal" href="#unicode-mathematical-typesetting">Unicode mathematical +typesetting</a>.</p> <div class="section" id="math-font-selection"> <h2><a class="toc-backref" href="#id49"><span class="sectnum">4.1</span> Math font selection</a></h2> <p>There are three complementary methods to set font attributes in LaTeX -math mode: <cite>LaTeX 2e font selection</cite> <a class="citation-reference" href="#fntguide" id="id10">[fntguide]</a> describes <a class="reference internal" href="#math-alphabets">math +math mode: <cite>LaTeX 2e font selection</cite> <a class="citation-reference" href="#fntguide" id="id11">[fntguide]</a> describes <a class="reference internal" href="#math-alphabets">math alphabets</a> and <a class="reference internal" href="#math-versions">math versions</a>, several extension packages -provide alternative <a class="reference internal" href="#math-styles">math styles</a> (cf. <a class="reference internal" href="#table-2">Table 2</a>).</p> +provide alternative <a class="reference internal" href="#math-styles">math styles</a>.</p> <div class="section" id="math-alphabets"> -<span id="math-alphabet"></span><h3><a class="toc-backref" href="#id50"><span class="sectnum">4.1.1</span> Math alphabets</a></h3> -<p>Math alphabets are a counterpart to the <a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric +<span id="math-alphabet"></span><h3><span class="sectnum">4.1.1</span> Math alphabets</h3> +<p>TeX's <em>math alphabets</em> correspond to the <a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric symbols</a> block in Unicode. Both are “to be used for mathematical variables where style variations are important semantically”. -The font guide <a class="citation-reference" href="#fntguide" id="id11">[fntguide]</a> defines in +The font guide <a class="citation-reference" href="#fntguide" id="id12">[fntguide]</a> defines in section 3:</p> <blockquote> <p>Some math fonts are selected explicitly by one-argument commands @@ -1279,18 +1282,17 @@ commands that allow the attributes to be individually changed. Instead, the conversion from math fonts to these five attributes is controlled by the <a class="reference internal" href="#math-version">math version</a>.</p> <p>The <span class="target" id="predefined-math-alphabets">predefined math alphabets</span> are:</p> -<blockquote> <table class="borderless booktabs numbered align-left"> <colgroup> <col width="43%" /> <col width="58%" /> </colgroup> -<tbody valign="top"> +<tbody> <tr><td><p><tt class="literal">\mathnormal</tt></p></td> -<td><p>default<a class="footnote-reference" href="#mathnormal" id="id12"><sup>2</sup></a></p></td> +<td><p>default<a class="footnote-reference" href="#mathnormal" id="id13"><sup>2</sup></a></p></td> </tr> <tr><td><p><tt class="literal">\mathrm</tt></p></td> -<td><p>roman<a class="footnote-reference" href="#roman" id="id13"><sup>3</sup></a></p></td> +<td><p>roman<a class="footnote-reference" href="#roman" id="id14"><sup>3</sup></a></p></td> </tr> <tr><td><p><tt class="literal">\mathbf</tt></p></td> <td><p>bold roman</p></td> @@ -1310,15 +1312,14 @@ controlled by the <a class="reference internal" href="#math-version">math versio </tbody> </table> </blockquote> -</blockquote> -<dl class="footnote"><dt class="label"><a class="fn-backref" href="#id12">2</a></dt> +<dl class="footnote"><dt class="label"><a class="fn-backref" href="#id13">2</a></dt> <dd id="mathnormal"> <p class="first last"><tt class="literal">\mathnormal</tt> is used by default for alphanumeric characters in math mode. It sets the letter shape according to character class and <a class="reference internal" href="#math-style">math style</a>. (<a class="reference internal" href="#table-1">Table 1</a> shows the default letter shapes for common math styles).</p> </dd> -<dt class="label"><a class="fn-backref" href="#id13">3</a></dt> +<dt class="label"><a class="fn-backref" href="#id14">3</a></dt> <dd id="roman"> <p class="first last">The specifier “roman” is ambiguous: roman shape stands for <em>upright</em>, while roman type stands for <em>serif</em> (as @@ -1331,30 +1332,56 @@ opposed to sans serif).</p> letter <tt class="literal">a</tt> in <strong>upright</strong> bold type.</p> </div> <div class="section" id="math-versions"> -<span id="math-version"></span><h3><a class="toc-backref" href="#id51"><span class="sectnum">4.1.2</span> Math versions</a></h3> -<p>The number of mathematical symbols exceeds the maximal number of -characters in a TeX font file by an order of magnitude.<a class="footnote-reference" href="#max" id="id14"><sup>4</sup></a> -Grouping math fonts with common characteristics in math versions -simplifies the setting of font attributes for mathematical expressions.</p> -<p><em>Math versions</em> set up “math symbol fonts” for non-alphanumeric -symbols and bind the <a class="reference internal" href="#math-alphabet">math alphabet</a> commands to fonts using default -values for non-specified font attributes. TeX limits the number of -(symbol + alphanumeric) fonts per math version to 16.</p> +<span id="math-version"></span><h3><span class="sectnum">4.1.2</span> Math versions</h3> +<p><em>Math versions</em> specify the mapping from commands for mathematical +symbols and <a class="reference internal" href="#math-alphabets">math alphabets</a> to a set of mathematical fonts<a class="footnote-reference" href="#id17" id="id15"><sup>4</sup></a>. +They are intended for mathematical content in a special context like a +bold section heading. Selecting a math version resembles +the individual selection of text font attributes.</p> +<dl class="docutils"> +<dt>Example:</dt> +<dd><p>Some alternatives to set the letter <tt class="literal">a</tt> in a bold upright sans-serif +font:</p> +<table class="borderless booktabs numbered align-left"> +<colgroup> +<col width="44%" /> +<col width="56%" /> +</colgroup> +<thead valign="bottom"> +<tr><th class="head"><p>Text</p></th> +<th class="head"><p>Math</p></th> +</tr> +</thead> +<tbody> +<tr><td><p><tt class="literal"><span class="pre">\textbf{\textsf{a}}</span></tt></p></td> +<td><p><tt class="literal"><span class="pre">$\bm{\mathsf{a}}$</span></tt></p></td> +</tr> +<tr><td><p><tt class="literal">\bfseries \textsf{a}</tt></p></td> +<td><p><tt class="literal">\mathversion{bold} $\mathsf{a}$</tt></p></td> +</tr> +<tr><td><p><tt class="literal">\bfseries \sffamily a</tt></p></td> +<td><p><tt class="literal">$\mathsfbf{a}$</tt></p></td> +</tr> +</tbody> +</table> +</dd> +</dl> <p>The predefined math versions are <tt class="literal">normal</tt> and <tt class="literal">bold</tt> with the -defaults:</p> +following defaults for non-specified font attributes:</p> <blockquote> -<table class="borderless booktabs numbered align-left"> +<table class="booktabs numbered align-left"> <colgroup> -<col width="31%" /> -<col width="38%" /> -<col width="31%" /> +<col width="33%" /> +<col width="37%" /> +<col width="30%" /> </colgroup> -<tbody valign="top"> -<tr><td><!-- --> -</td> -<td><p><tt class="literal">normal</tt></p></td> -<td><p><tt class="literal">bold</tt></p></td> +<thead valign="bottom"> +<tr><th class="head"><p>attribute</p></th> +<th class="head"><p><tt class="literal">normal</tt></p></th> +<th class="head"><p><tt class="literal">bold</tt></p></th> </tr> +</thead> +<tbody> <tr><td><p><em>type</em></p></td> <td><p>serif</p></td> <td><p>serif</p></td> @@ -1370,36 +1397,42 @@ defaults:</p> </tbody> </table> </blockquote> -<p>Packages can define additional math versions, e. g., the <a class="reference external" href="http://phong.informatik.uni-leipzig.de/~kuska/wri_texmf_4.2.zip">wrisym</a> package -defines a <tt class="literal">mono</tt> math version. A <tt class="literal">sans</tt> math version example is -available from a <a class="reference external" href="http://newsgroups.derkeiler.com/Archive/Comp/comp.text.tex/2007-09/msg00181.html">comp.text.tex post</a></p> -<p>Math versions are intended for mathematical content in a special -context, e. g., a bold section heading. -Setting a math version resembles the individual selection of text -font attributes (bold, sans-serif, monospaced).</p> +<p>Packages can define additional math versions, e. g., the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kpfonts.html">kpfonts</a> package +defines a <tt class="literal">sans</tt> math version (another <tt class="literal">sans</tt> math version example is +available from a <a class="reference external" href="http://newsgroups.derkeiler.com/Archive/Comp/comp.text.tex/2007-09/msg00181.html">comp.text.tex post`</a>) and the <a class="reference external" href="http://phong.informatik.uni-leipzig.de/~kuska/wri_texmf_4.2.zip">wrisym</a> package defines a +<tt class="literal">mono</tt> math version.</p> <p>Math versions can only be changed outside of math mode. The commands <tt class="literal">\boldsymbol</tt> (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/amsmath.html">amsmath</a>) and <tt class="literal">\bm</tt> (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/bm.html">bm</a>) behave like <span class="target" id="in-line-math-versions">“in-line math versions”</span>: they typeset their argument using the fonts of the <tt class="literal">bold</tt> math version but can be used inside math mode.</p> -<p>Example: four ways to set the letter <tt class="literal">a</tt> in a bold -sans-serif font:</p> -<pre class="literal-block">% Text Math: -\textbf{\textsf{a}} $\bm{\mathsf{a}}$ -\bfseries \textsf{a} \mathversion{bold} $\mathsf{a}$ -</pre> -<dl class="footnote"><dt class="label"><a class="fn-backref" href="#id14">4</a></dt> -<dd id="max"> -<p class="first last">Unicode provides about 2500 math characters. Font files used -by 8-bit TeX engines can hold up to 256 characters. The standard -math fonts adhere to the original limit of 128 characters.</p> +<dl class="footnote"><dt class="label"><a class="fn-backref" href="#id15">4</a></dt> +<dd id="id17"> +<p class="first last">The number of mathematical symbols exceeds the maximal number of +characters in a TeX font file by an order of magnitude: Unicode +defines about 2500 mathematical characters <a class="citation-reference" href="#tr25" id="id18">[tr25]</a>, font files used by +8-bit TeX engines are limited to 256 characters. The standard math +fonts adhere to the original limit of 128 characters. Grouping math +fonts with common characteristics in math versions simplifies the +setting of font attributes for mathematical expressions. TeX limits +the number of (symbol + alphanumeric) fonts per math version to 16.</p> </dd> </dl> </div> <div class="section" id="math-styles"> -<span id="math-style"></span><h3><a class="toc-backref" href="#id52"><span class="sectnum">4.1.3</span> Math styles</a></h3> +<span id="math-style"></span><h3><span class="sectnum">4.1.3</span> Math styles</h3> <p>A <em>math style</em> is a document-level feature that determines the default letter shape in math mode (i. e. the shape attribute of letters in the -<tt class="literal">\mathnormal</tt> <a class="reference internal" href="#math-alphabet">math alphabet</a>).</p> +<tt class="literal">\mathnormal</tt> <a class="reference internal" href="#math-alphabet">math alphabet</a>).<a class="footnote-reference" href="#id20" id="id19"><sup>5</sup></a> +LaTeX defaults to the “TeX” math style (without naming it such). +Alternative math styles are introduced by extension packages +(<a class="reference internal" href="#table-2">Table 2</a>).</p> +<dl class="footnote"><dt class="label"><a class="fn-backref" href="#id19">5</a></dt> +<dd id="id20"> +<p class="first last">The <tt class="literal"><span class="pre">math-style</span></tt> option of <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/unicode-math.html">unicode-math</a> changes also the shape +attribute of other math alphabets (see also section +<a class="reference internal" href="#the-unicode-math-package">the unicode-math package</a>).</p> +</dd> +</dl> <table class="booktabs numbered align-left" id="table-1"> <caption>Default letter shapes for common math styles</caption> <colgroup> @@ -1417,7 +1450,7 @@ letter shape in math mode (i. e. the shape attribute of letters in the <th class="head"><p>Greek</p></th> </tr> </thead> -<tbody valign="top"> +<tbody> <tr><td><p>TeX</p></td> <td><p>it</p></td> <td><p>it</p></td> @@ -1444,11 +1477,8 @@ letter shape in math mode (i. e. the shape attribute of letters in the </tr> </tbody> </table> -<p>LaTeX defaults to the “TeX” math style (without naming it such). -Alternative math styles are introduced by extension packages -(<a class="reference internal" href="#table-2">Table 2</a>).</p> <table class="booktabs numbered align-left" id="table-2"> -<caption>Packages providing math styles</caption> +<caption>Packages providing alternative math styles</caption> <colgroup> <col width="18%" /> <col width="20%" /> @@ -1460,7 +1490,7 @@ Alternative math styles are introduced by extension packages <th class="head"><p>Option(s)</p></th> </tr> </thead> -<tbody valign="top"> +<tbody> <tr><td><p>ISO</p></td> <td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixmath.html">fixmath</a></p></td> <td> </td> @@ -1542,30 +1572,30 @@ Alternative math styles are introduced by extension packages </table> </div> </div> -<div class="section" id="math-letter-fonts"> -<h2><a class="toc-backref" href="#id53"><span class="sectnum">4.2</span> Math letter fonts</a></h2> -<p>The equal treatment of Latin and Greek letters in the <a class="reference internal" href="#iso-math-style">ISO math -style</a> is simplest achieved with a font that contains all required +<div class="section" id="oml-font-encoding"> +<h2><a class="toc-backref" href="#id50"><span class="sectnum">4.2</span> OML font encoding</a></h2> +<p>The equal treatment of Latin and Greek letters in the <a class="reference internal" href="#iso-math-style">“ISO” math +style</a> is best achieved with a font that contains all required letters in one file.</p> <p>There is only one established LaTeX font encoding that contains Latin and Greek letters, the <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>. The standard Greek font encoding <cite>T7</cite> is just a “reserved name” and the de-facto standard Greek text font encoding <cite>LGR</cite> has no Latin letters. Unfortunately, <a class="reference internal" href="#oml-support">OML support</a> is limited to a few (mostly italic) fonts.</p> -<div class="section" id="oml-font-encoding"> -<h3><a class="toc-backref" href="#id54"><span class="sectnum">4.2.1</span> OML font encoding</a></h3> -<p>The <cite>LaTeX font encodings</cite> guide <a class="citation-reference" href="#encguide" id="id15">[encguide]</a> names the OML encoding +<div class="section" id="discussion"> +<h3><span class="sectnum">4.2.1</span> Discussion</h3> +<p>The <cite>LaTeX font encodings</cite> guide <a class="citation-reference" href="#encguide" id="id21">[encguide]</a> names the OML encoding <cite>TeX math italic</cite> and defines:</p> <blockquote> -<p>The <span class="target" id="oml">OML</span> encoding contains italic Latin and Greek letters for use in -mathematical formulas (typically used for variables) together with some +<p>The OML encoding contains italic Latin and Greek letters for use in +mathematical formulae (typically used for variables) together with some symbols.</p> </blockquote> <p>The reference to <em>italic</em> shape is odd:</p> <ul class="simple"> -<li><p>No other font encoding is specific to the font shape.</p></li> +<li><p>No other font encoding is specific to a font shape.</p></li> <li><p>The different font selection and the semantic of font features in -math do not interfere with the font <em>encoding</em>: Both, +mathematical formulae do not interfere with the font <em>encoding</em>: Both, <tt class="literal">\DeclareSymbolFont</tt> and <tt class="literal">\DeclareMathAlphabet</tt> require a shape argument. Thus it is possible to set up OML encoded math alphabets in roman {n} as well as italic {it} shape without @@ -1579,7 +1609,7 @@ Modern fonts: <cite>Computer Modern Math Italic</cite> (cmmi).</p> <li><p>Drop the <em>italic</em> from the definition. Optionally add an explanation:</p> <blockquote> <p>The OML encoding contains Latin and Greek letters for use in -mathematical formulas (typically used for variables) together with +mathematical formulae (typically used for variables) together with some symbols. It first appeared in the <cite>Computer Modern Math Italic</cite> (cmmi) font.</p> </blockquote> @@ -1593,12 +1623,12 @@ Math Letters</cite>. The latter would also explain the acronym OML.</p> </ul> </div> <div class="section" id="oml-support"> -<h3><a class="toc-backref" href="#id55"><span class="sectnum">4.2.2</span> OML Support</a></h3> +<h3><span class="sectnum">4.2.2</span> OML Support</h3> <p>Unfortunately, support for the OML encoding is missing for many font families even if the text font defines Greek letters. Supported font families can be found searching for <tt class="literal"><span class="pre">oml*.fd</span></tt> files and grepping for <tt class="literal"><span class="pre">DeclareFont.*OML</span></tt> in <tt class="literal">*.sty</tt> files.</p> -<p><a class="reference internal" href="#table-3">Table 3</a> lists the findings for a selection of TeXLive 2009 + some +<p><a class="reference internal" href="#table-3">Table 3</a> lists the findings for a selection of TeXLive 2012 + some additionally installed font packages.</p> <ul class="simple"> <li><p>If there is an alias (substitution) from the text font to a @@ -1607,56 +1637,52 @@ math-variant, only the text font is listed.</p></li> however mapping to an italic variant of the OML encoded font. These are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal">bx/n</tt> here.</p></li> </ul> +<p><a class="reference internal" href="#table-4">Table 4</a> lists some fonts that define <tt class="literal">cmm</tt> as OML substitution. +With <cite>isomath</cite>, a better matching substitution can be set using the +<a class="reference internal" href="#rmdefault">rmdefault</a> or <a class="reference internal" href="#sfdefault">sfdefault</a> options.</p> <table class="booktabs numbered align-left" id="table-3"> <caption>Font families supporting the OML encoding</caption> <colgroup> -<col width="19%" /> -<col width="40%" /> -<col width="10%" /> -<col width="12%" /> +<col width="18%" /> +<col width="45%" /> +<col width="9%" /> +<col width="11%" /> +<col width="8%" /> <col width="9%" /> -<col width="10%" /> </colgroup> <thead valign="bottom"> <tr><th class="head"><p>Name</p></th> -<th class="head"><p>Family</p></th> +<th class="head"><p>Family (package)</p></th> <th class="head"><p>m/it</p></th> <th class="head"><p>bx/it</p></th> <th class="head"><p>m/n</p></th> <th class="head"><p>bx/n</p></th> </tr> </thead> -<tbody valign="top"> -<tr><td><p>aer</p></td> -<td><p>AE (Almost European)</p></td> -<td><p>✓</p></td> -<td><p>✓</p></td> -<td> </td> -<td> </td> -</tr> +<tbody> <tr><td><p>antt</p></td> -<td><p>Antykwa Torunska</p></td> +<td><p>Antykwa Torunska (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/anttor.html">anttor</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>cmr</p></td> -<td><p>Computer Modern Roman</p></td> +<td><p>Computer Modern</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>ccr</p></td> -<td><p>Concrete</p></td> +<td><p>Concrete Roman (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/concmath.html">concmath</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>cmbr</p></td> -<td><p>Computer Modern Bright</p></td> +<td><p>CM Bright (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/cmbright.html">cmbright</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> @@ -1677,70 +1703,161 @@ are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal" <td> </td> </tr> <tr><td><p>iwona</p></td> -<td><p>Iwona (sans serif)</p></td> +<td><p>Iwona (sans serif) (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/iwona.html">iwona</a>)</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>iwonal</p></td> +<td><p>Iwona light</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>iwonac</p></td> +<td><p>Iwona condensed</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>iwonalc</p></td> +<td><p>Iwona light condensed</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>jkp</p></td> -<td><p>Kepler Serif</p></td> +<td><p>Kepler Serif (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kpfonts.html">kpfonts</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> -<tr><td><p>jkpl</p></td> -<td><p>Kepler Serif</p></td> +<tr><td><p>jkpw</p></td> +<td><p>Kepler Serif wide</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>jkpvos</p></td> -<td><p>Kepler Serif</p></td> +<td><p>Kepler Serif oldstyle</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>jkpvosw</p></td> +<td><p>Kepler Serif oldstyle wide</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>jkpl</p></td> +<td><p>Kepler Serif light</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>jkplw</p></td> +<td><p>Kepler Serif light wide</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>jkplvos</p></td> -<td><p>Kepler Serif</p></td> +<td><p>Kepler Serif light oldstyle</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>jkplvosw</p></td> +<td><p>Kepler Serif light os wide</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>jkpss</p></td> +<td><p>Kepler Sans (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kpfonts.html">kpfonts</a>)</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>jkpssvos</p></td> +<td><p>Kepler Sans oldstyle</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>jtm</p></td> +<td><p>expanded Times (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/jamtimes.html">jamtimes</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>llcmm</p></td> -<td><p>LX Fonts (sans serif)</p></td> +<td><p>LX Fonts (sans serif) (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/lxfonts.html">lxfonts</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>lmr</p></td> -<td><p>Latin Modern Roman</p></td> +<td><p>Latin Modern Roman (lmodern)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>mak</p></td> -<td><p>Kerkis</p></td> +<td><p>Kerkis (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kerkis.html">kerkis</a>)</p></td> <td><p>✓</p></td> <td> </td> <td> </td> <td> </td> </tr> <tr><td><p>kurier</p></td> -<td><p>Kurier</p></td> +<td><p>Kurier (sans serif) (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kurier.html">kurier</a>)</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>kurierc</p></td> +<td><p>Kurier condensed</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>kurierl</p></td> +<td><p>Kurier light</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>kurierlc</p></td> +<td><p>Kurier light condensed</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>mdbch</p></td> -<td><p>Math Design Charter</p></td> +<td><p>Math Design Charter (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html">mathdesign</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td><p>✓</p></td> @@ -1761,10 +1878,24 @@ are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal" <td><p>✓</p></td> </tr> <tr><td><p>neohellenic</p></td> -<td><p>GFS Neohellenic</p></td> +<td><p>Neohellenic (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/gfsneohellenic.html">gfsneohellenic</a>)</p></td> +<td><p>✓</p></td> +<td> </td> +<td> </td> +<td> </td> +</tr> +<tr><td><p>ntxmi</p></td> +<td><p>Times (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/newtx.html">newtx</a>)</p></td> +<td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> +</tr> +<tr><td><p>nxlmi</p></td> +<td><p>Libertine (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/newtx.html">newtx</a>)</p></td> +<td><p>✓</p></td> +<td><p>✓</p></td> +<td> </td> <td> </td> </tr> <tr><td><p>plcm</p></td> @@ -1789,14 +1920,14 @@ are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal" <td> </td> </tr> <tr><td><p>ptmcm</p></td> -<td><p>Times (psfont)</p></td> +<td><p>Times (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathptmx.html">mathptmx</a>)</p></td> <td><p>✓</p></td> <td> </td> <td> </td> <td> </td> </tr> <tr><td><p>pxr</p></td> -<td><p>Palatino (pxfonts)</p></td> +<td><p>Palatino (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/pxfonts.html">pxfonts</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> @@ -1817,21 +1948,21 @@ are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal" <td> </td> </tr> <tr><td><p>txr</p></td> -<td><p>Times (txfonts)</p></td> +<td><p>Times (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/txfonts.html">txfonts</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> <td> </td> </tr> <tr><td><p>udidot</p></td> -<td><p>Didot (gfsdidot)</p></td> +<td><p>Didot (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/gfsdidot.html">gfsdidot</a>)</p></td> <td><p>✓</p></td> <td> </td> <td> </td> <td> </td> </tr> <tr><td><p>ywclm</p></td> -<td><p>(greektex)</p></td> +<td><p>(<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/greektex.html">greektex</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> @@ -1844,15 +1975,8 @@ are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal" <td> </td> <td> </td> </tr> -<tr><td><p>zesfcm</p></td> -<td><p>(efont)</p></td> -<td><p>✓</p></td> -<td> </td> -<td> </td> -<td> </td> -</tr> <tr><td><p>zplm</p></td> -<td><p>Palatino (mathpazo)</p></td> +<td><p>Palatino (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathpazo.html">mathpazo</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> @@ -1866,14 +1990,14 @@ are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal" <td> </td> </tr> <tr><td><p>ztmcm</p></td> -<td><p>Times (mathptmv)</p></td> +<td><p>Times (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathptmx.html">mathptmx</a>)</p></td> <td><p>✓</p></td> <td> </td> <td> </td> <td> </td> </tr> <tr><td><p>zer</p></td> -<td><p>Computer Modern (zefonts)</p></td> +<td><p>Computer Modern (<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/zefonts.html">zefonts</a>)</p></td> <td><p>✓</p></td> <td><p>✓</p></td> <td> </td> @@ -1881,9 +2005,6 @@ are not listed as supporting <tt class="literal">m/n</tt> or <tt class="literal" </tr> </tbody> </table> -<p><a class="reference internal" href="#table-4">Table 4</a> lists some fonts that define <tt class="literal">cmm</tt> as OML substitution. -With <cite>isomath</cite>, a better matching substitution can be set using the -<a class="reference internal" href="#rmdefault">rmdefault</a> or <a class="reference internal" href="#sfdefault">sfdefault</a> options.</p> <table class="booktabs numbered align-left" id="table-4"> <caption>Non-CM fonts with <tt class="literal">cmm</tt> as OML substitution</caption> <colgroup> @@ -1895,7 +2016,7 @@ With <cite>isomath</cite>, a better matching substitution can be set using the <th class="head"><p>Name</p></th> </tr> </thead> -<tbody valign="top"> +<tbody> <tr><td><p>bch</p></td> <td><p>Charter (psnfss)</p></td> </tr> @@ -1939,7 +2060,7 @@ With <cite>isomath</cite>, a better matching substitution can be set using the <td><p>Courier</p></td> </tr> <tr><td><p>unc</p></td> -<td><p>New Courier (nctrsbk)</p></td> +<td><p>New Century Schoolbook (psnfss)</p></td> </tr> <tr><td><p>uni</p></td> <td><p>Universal (universa)</p></td> @@ -1961,29 +2082,65 @@ With <cite>isomath</cite>, a better matching substitution can be set using the </div> </div> <div class="section" id="unicode-mathematical-typesetting"> -<h2><a class="toc-backref" href="#id56"><span class="sectnum">4.3</span> Unicode mathematical typesetting</a></h2> -<p>The technical report <a class="citation-reference" href="#tr25" id="id16">[tr25]</a> presents an in-depth discussion of the -mathematics character repertoire of the Unicode Standard as well as +<h2><a class="toc-backref" href="#id51"><span class="sectnum">4.3</span> Unicode mathematical typesetting</a></h2> +<p>This section compares <a class="reference internal" href="#math-font-selection">math font selection</a> in LaTeX and Unicode. It +suggests a set of 14 math alphabet commands that covers all Unicode +<a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric symbols</a> and discusses compatibility issues +between math typesetting with traditional (8-bit) TeX engines versus <a class="reference internal" href="#the-unicode-math-package">the +unicode-math package</a> for Unicode-enabled TeX engines (XeTeX, LuaTeX).</p> +<p>The technical report <a class="citation-reference" href="#tr25" id="id22">[tr25]</a> presents an in-depth discussion of the +mathematical character repertoire of the Unicode Standard as well as mathematical notation in general.</p> -<p>This section compares <a class="reference internal" href="#math-font-selection">math font selection</a> in LaTeX and Unicode. -It suggests a set of 14 math alphabets that covers all Unicode -<a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric symbols</a> and discusses compatibility -issues between math typesetting with traditional (8-bit) TeX engines -versus <a class="reference internal" href="#the-unicode-math-package">the unicode-math package</a> for Unicode-enabled TeX engines -(XeTeX, LuaTeX).</p> -<div class="section" id="unicode-math-alphabets"> -<span id="mathematical-alphanumeric-symbols"></span><h3><a class="toc-backref" href="#id57"><span class="sectnum">4.3.1</span> Unicode math alphabets</a></h3> -<p>Chapter 2 <cite>Mathematical Character Repertoire</cite> of <a class="citation-reference" href="#tr25" id="id17">[tr25]</a> lists 14 +<div class="section" id="unicode-mathematical-alphabets"> +<span id="mathematical-alphanumeric-symbols"></span><h3><span class="sectnum">4.3.1</span> Unicode mathematical alphabets</h3> +<p>Chapter 2 <cite>Mathematical Character Repertoire</cite> of <a class="citation-reference" href="#tr25" id="id23">[tr25]</a> lists 14 <cite>Mathematical Alphabets</cite> in Table 2.1. These mathematical alphabets are a superset of the predefined <a class="reference internal" href="#math-alphabets">math alphabets</a> in the LaTeX core.</p> -<p>Unicode assignes code points to most letters of the mathematical +<p>Unicode assigns code points to most letters of the mathematical alphabets in the <a class="reference external" href="http://www.unicode.org/charts/PDF/U1D400.pdf">mathematical alphanumeric symbols Unicode block</a>. -The plain (upright, serifed) letters have been unified with the +The plain (upright) letters have been unified with the existing characters in the Basic Latin and Greek blocks.</p> <p><a class="reference internal" href="#table-5">Table 5</a> maps the 14 Unicode mathematical alphabets to LaTeX commands according to the <a class="reference internal" href="#naming-scheme">naming scheme</a> below. <a class="reference internal" href="#table-6">Table 6</a> lists the status of -LaTeX support for the mathematical alphanumeric symbols. Full support is -provided by <a class="reference internal" href="#the-unicode-math-package">the unicode-math package</a>.</p> +LaTeX support for the mathematical alphanumeric symbols.</p> +<div class="section" id="naming-scheme"> +<h4><span class="sectnum">4.3.1.1</span> Naming scheme</h4> +<p>The naming scheme is an extension of the predefined <a class="reference internal" href="#math-alphabet">math alphabet</a> +commands with the established short-cuts:</p> +<table class="borderless booktabs numbered align-left"> +<colgroup> +<col width="14%" /> +<col width="86%" /> +</colgroup> +<tbody> +<tr><td><p>bf</p></td> +<td><p>bold</p></td> +</tr> +<tr><td><p>it</p></td> +<td><p>italic</p></td> +</tr> +<tr><td><p>cal</p></td> +<td><p>script (calligraphic)</p></td> +</tr> +<tr><td><p>frak</p></td> +<td><p>fraktur</p></td> +</tr> +<tr><td><p>bb</p></td> +<td><p>double-struck (blackboard bold)</p></td> +</tr> +<tr><td><p>sf</p></td> +<td><p>sans serif</p></td> +</tr> +</tbody> +</table> +<p>combined to commands in the form <tt class="literal"><span class="pre">\math<type><weight><shape></span></tt>.</p> +<p>The <<em>type</em>>, <<em>weight</em>>, and <<em>shape</em>> specifiers are optional +(defaults depend on the <a class="reference internal" href="#math-version">math version</a>). Their order matches the +names of Unicode <a class="reference internal" href="#mathematical-alphanumeric-symbols">Mathematical Alphanumeric Symbols</a>.</p> +<p>Examples:</p> +<pre class="literal-block">\mathbf{d} % MATHEMATICAL BOLD SMALL D +\mathsfbfit{d} % MATHEMATICAL SANS-SERIF BOLD ITALIC SMALL D. +</pre> <table class="booktabs numbered align-left" id="table-5"> <caption>Mapping Unicode <a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric symbols</a> to LaTeX math alphabets.</caption> @@ -2002,11 +2159,11 @@ math alphabets.</caption> <th class="head"><p>math alphabet</p></th> </tr> </thead> -<tbody valign="top"> +<tbody> <tr><td><p><em>serif</em></p></td> <td><p><em>medium</em></p></td> <td><p><em>upright</em></p></td> -<td><p>Latin/Greek/digits<a class="footnote-reference" href="#up" id="id18"><sup>5</sup></a></p></td> +<td><p>Latin/Greek/digits<a class="footnote-reference" href="#up" id="id24"><sup>6</sup></a></p></td> <td><p><tt class="literal">\mathrm</tt></p></td> </tr> <tr><td><!-- --> @@ -2098,52 +2255,18 @@ math alphabets.</caption> </tr> </tbody> </table> -<dl class="footnote"><dt class="label">5</dt> +<dl class="footnote"><dt class="label">6</dt> <dd id="up"> -<em>(<a class="fn-backref" href="#id18">1</a>, <a class="fn-backref" href="#id19">2</a>)</em> <p class="last">plain standard characters outside the +<em>(<a class="fn-backref" href="#id24">1</a>, <a class="fn-backref" href="#id25">2</a>)</em> <p class="last">plain standard characters outside the <cite>mathematical alphanumeric symbols</cite> Unicode block.</p> </dd> </dl> -<div class="section" id="naming-scheme"> -<h4><a class="toc-backref" href="#id58"><span class="sectnum">4.3.1.1</span> Naming scheme</a></h4> -<p>The naming scheme is an extension of the predefined <a class="reference internal" href="#math-alphabet">math alphabet</a> -commands with the short-cuts</p> -<blockquote> -<table class="borderless booktabs numbered align-left"> -<colgroup> -<col width="14%" /> -<col width="86%" /> -</colgroup> -<tbody valign="top"> -<tr><td><p>bf</p></td> -<td><p>bold,</p></td> -</tr> -<tr><td><p>it</p></td> -<td><p>italic,</p></td> -</tr> -<tr><td><p>cal</p></td> -<td><p>script (calligraphic),</p></td> -</tr> -<tr><td><p>frak</p></td> -<td><p>fraktur,</p></td> -</tr> -<tr><td><p>bb</p></td> -<td><p>double-struck (blackboard bold),</p></td> -</tr> -<tr><td><p>sf</p></td> -<td><p>sans serif</p></td> -</tr> -</tbody> -</table> -</blockquote> -<p>combined to commands in the form <tt class="literal"><span class="pre">\math<type><weight><shape></span></tt>.</p> -<p>The <<em>type</em>>, <<em>weight</em>>, and <<em>shape</em>> specifiers are optional -(defaults depend on the <a class="reference internal" href="#math-version">math version</a>). Their order matches the -names of Unicode <a class="reference internal" href="#mathematical-alphanumeric-symbols">Mathematical Alphanumeric Symbols</a>.</p> -<p>Examples:</p> -<pre class="literal-block">\mathbf{d} % MATHEMATICAL BOLD SMALL D -\mathsfbfit{d} % MATHEMATICAL SANS-SERIF BOLD ITALIC SMALL D. -</pre> +</div> +<div class="section" id="latex-support"> +<h4><span class="sectnum">4.3.1.2</span> LaTeX support</h4> +<p>Most commonly used math alphabets are supported either by the TeX kernel +or additional packages. Full support is only provided by <a class="reference internal" href="#the-unicode-math-package">the unicode-math +package</a>.</p> <table class="booktabs numbered align-left" id="table-6"> <caption>LaTeX support for <a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric symbols</a>.</caption> <colgroup> @@ -2157,33 +2280,33 @@ names of Unicode <a class="reference internal" href="#mathematical-alphanumeric- <th class="head"><p>package, comment</p></th> </tr> </thead> -<tbody valign="top"> -<tr><td><p>plain<a class="footnote-reference" href="#up" id="id19"><sup>5</sup></a></p></td> +<tbody> +<tr><td><p>plain<a class="footnote-reference" href="#up" id="id25"><sup>6</sup></a></p></td> <td><p><tt class="literal">\mathrm</tt></p></td> -<td><p>predefined<a class="footnote-reference" href="#no-g" id="id20"><sup>6</sup></a></p></td> +<td><p>predefined<a class="footnote-reference" href="#no-g" id="id26"><sup>7</sup></a></p></td> </tr> <tr><td><!-- --> </td> <td><p><tt class="literal">\mathup</tt></p></td> -<td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/unicode-math.html">unicode-math</a></p></td> +<td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/unicode-math.html">unicode-math</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kpfonts.html">kpfonts</a></p></td> </tr> <tr><td><p>bf</p></td> <td><p><tt class="literal">\mathbf</tt></p></td> -<td><p>predefined<a class="footnote-reference" href="#no-g" id="id21"><sup>6</sup></a></p></td> +<td><p>predefined<a class="footnote-reference" href="#no-g" id="id27"><sup>7</sup></a></p></td> </tr> <tr><td><p>it</p></td> <td><p><tt class="literal">\mathit</tt></p></td> -<td><p>predefined<a class="footnote-reference" href="#no-g" id="id22"><sup>6</sup></a></p></td> +<td><p>predefined<a class="footnote-reference" href="#no-g" id="id28"><sup>7</sup></a></p></td> </tr> <tr><td><p>bf it</p></td> <td><p><tt class="literal">\mathbfit</tt></p></td> -<td><p>isomath<a class="footnote-reference" href="#digits" id="id23"><sup>7</sup></a></p></td> +<td><p>isomath<a class="footnote-reference" href="#digits" id="id29"><sup>8</sup></a></p></td> </tr> <tr><td><!-- --> </td> <td><p><tt class="literal">\mathbold</tt></p></td> <td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixmath.html">fixmath</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathpazo.html">mathpazo</a>, -<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathptmx.html">mathptmx</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/tmmath.html">tmmath</a><a class="footnote-reference" href="#digits" id="id24"><sup>7</sup></a></p></td> +<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathptmx.html">mathptmx</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/tmmath.html">tmmath</a><a class="footnote-reference" href="#digits" id="id30"><sup>8</sup></a></p></td> </tr> <tr><td><!-- --> </td> @@ -2197,7 +2320,7 @@ names of Unicode <a class="reference internal" href="#mathematical-alphanumeric- </tr> <tr><td><p>cal</p></td> <td><p><tt class="literal">\mathcal</tt></p></td> -<td><p>predefined<a class="footnote-reference" href="#script" id="id25"><sup>8</sup></a></p></td> +<td><p>predefined<a class="footnote-reference" href="#script" id="id31"><sup>9</sup></a></p></td> </tr> <tr><td><!-- --> </td> @@ -2221,7 +2344,7 @@ names of Unicode <a class="reference internal" href="#mathematical-alphanumeric- <td><p><tt class="literal">\mathbb</tt></p></td> <td><p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/amssymb.html">amssymb</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/bbold.html">bbold</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathbbol.html">mathbbol</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mbboard.html">mbboard</a>, -<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathpazo.html">mathpazo</a></p></td> +<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathpazo.html">mathpazo</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/sbbm.html">sbbm</a></p></td> </tr> <tr><td><!-- --> </td> @@ -2235,7 +2358,7 @@ names of Unicode <a class="reference internal" href="#mathematical-alphanumeric- </tr> <tr><td><p>sf</p></td> <td><p><tt class="literal">\mathsf</tt></p></td> -<td><p>predefined<a class="footnote-reference" href="#no-g" id="id26"><sup>6</sup></a></p></td> +<td><p>predefined<a class="footnote-reference" href="#no-g" id="id32"><sup>7</sup></a></p></td> </tr> <tr><td><p>sf bf</p></td> <td><p><tt class="literal">\mathbfsfup</tt></p></td> @@ -2243,11 +2366,11 @@ names of Unicode <a class="reference internal" href="#mathematical-alphanumeric- </tr> <tr><td><p>sf it</p></td> <td><p><tt class="literal">\mathsfit</tt></p></td> -<td><p>isomath<a class="footnote-reference" href="#digits" id="id27"><sup>7</sup></a></p></td> +<td><p>isomath<a class="footnote-reference" href="#digits" id="id33"><sup>8</sup></a></p></td> </tr> <tr><td><p>sf bf it</p></td> <td><p><tt class="literal">\mathsfbfit</tt></p></td> -<td><p>isomath<a class="footnote-reference" href="#digits" id="id28"><sup>7</sup></a></p></td> +<td><p>isomath<a class="footnote-reference" href="#digits" id="id34"><sup>8</sup></a></p></td> </tr> <tr><td><!-- --> </td> @@ -2261,43 +2384,44 @@ names of Unicode <a class="reference internal" href="#mathematical-alphanumeric- </tr> <tr><td><p>tt</p></td> <td><p><tt class="literal">\mathtt</tt></p></td> -<td><p>predefined<a class="footnote-reference" href="#no-g" id="id29"><sup>6</sup></a></p></td> +<td><p>predefined<a class="footnote-reference" href="#no-g" id="id35"><sup>7</sup></a></p></td> </tr> </tbody> </table> -<dl class="footnote"><dt class="label">6</dt> +<dl class="footnote"><dt class="label">7</dt> <dd id="no-g"> -<em>(<a class="fn-backref" href="#id20">1</a>, <a class="fn-backref" href="#id21">2</a>, <a class="fn-backref" href="#id22">3</a>, <a class="fn-backref" href="#id26">4</a>, <a class="fn-backref" href="#id29">5</a>)</em> <p class="last">no small Greek, full Greek with <a class="reference internal" href="#omlmath">OMLmath*</a> options.</p> +<em>(<a class="fn-backref" href="#id26">1</a>, <a class="fn-backref" href="#id27">2</a>, <a class="fn-backref" href="#id28">3</a>, <a class="fn-backref" href="#id32">4</a>, <a class="fn-backref" href="#id35">5</a>)</em> <p class="last">no small Greek, full Greek with <a class="reference internal" href="#omlmath">OMLmath*</a> options and +OML-encoded fonts</p> </dd> -<dt class="label">7</dt> +<dt class="label">8</dt> <dd id="digits"> -<em>(<a class="fn-backref" href="#id23">1</a>, <a class="fn-backref" href="#id24">2</a>, <a class="fn-backref" href="#id27">3</a>, <a class="fn-backref" href="#id28">4</a>)</em> <p class="last">Some italic math fonts (e. g., cmr, cmbr) have old-style +<em>(<a class="fn-backref" href="#id29">1</a>, <a class="fn-backref" href="#id30">2</a>, <a class="fn-backref" href="#id33">3</a>, <a class="fn-backref" href="#id34">4</a>)</em> <p class="last">Some italic math fonts (e. g., cmr, cmbr) have old-style numbers in place of italic digits.</p> </dd> -<dt class="label"><a class="fn-backref" href="#id25">8</a></dt> +<dt class="label"><a class="fn-backref" href="#id31">9</a></dt> <dd id="script"> -<p class="first last">no small Latin, formal script with <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/calrsfs.html">calrsfs</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/eucal.html">eucal</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fourier.html">fourier</a></p> +<p class="first last">formal script with <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/calrsfs.html">calrsfs</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/eucal.html">eucal</a>, <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fourier.html">fourier</a>, +small Latin letters only with <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/urwchancal.html">urwchancal</a></p> </dd> </dl> </div> </div> <div class="section" id="the-unicode-math-package"> -<h3><a class="toc-backref" href="#id59"><span class="sectnum">4.3.2</span> The unicode-math package</a></h3> +<h3><span class="sectnum">4.3.2</span> The unicode-math package</h3> <p>Users of UTF-8 enabled TeX engines (XeTeX, LuaTeX) can typeset mathematics with the experimental <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/unicode-math.html">unicode-math</a> package by Will Robertson. It provides a LaTeX interface to OpenType fonts with math support, e. g., <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/asana-math.html">Asana Math</a>, Cambria Math, <a class="reference external" href="https://github.com/khaledhosny/euler-otf">New Euler</a> or <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/xits.html">XITS</a>, with -commands to access the complete mathematics character repertoire of the -Unicode Standard</p> +commands to access the complete mathematical character repertoire of the +Unicode Standard.</p> <p>LaTeX <a class="reference internal" href="#math-font-selection">math font selection</a> methods with unicode-math:</p> -<dl class="docutils"> -<dt><a class="reference internal" href="#math-alphabets">math alphabets</a></dt> -<dd><p>map to a range of the <a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric symbols</a> block in the -current font (or a substitution defined with the <tt class="literal">range</tt> math font -option).</p> +<ul> +<li><p><a class="reference internal" href="#math-alphabets">Math alphabets</a> map to a range of the <a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric +symbols</a> block in the current font (or a substitution defined with the +<tt class="literal">range</tt> math font option).</p> <p>Some command names differ from the <a class="reference internal" href="#predefined-math-alphabets">predefined math alphabets</a> or the above <a class="reference internal" href="#naming-scheme">naming scheme</a>:</p> -<table class="booktabs numbered align-left"> +<table class="borderless booktabs numbered align-left"> <colgroup> <col width="50%" /> <col width="50%" /> @@ -2307,7 +2431,7 @@ above <a class="reference internal" href="#naming-scheme">naming scheme</a>:</p> <th class="head"><p>unicode-math</p></th> </tr> </thead> -<tbody valign="top"> +<tbody> <tr><td><p><tt class="literal">\mathbf</tt></p></td> <td><p><tt class="literal">\mathbfup</tt></p></td> </tr> @@ -2328,50 +2452,26 @@ behave similar to <a class="reference internal" href="#in-line-math-versions"> achieved via the options <tt class="literal"><span class="pre">bold-style=upright</span></tt> and <tt class="literal"><span class="pre">sans-style=upright</span></tt>.</p> <p><tt class="literal">\mathbfsfit</tt> reverses the order of the <tt class="literal">sf</tt> and <tt class="literal">bf</tt> selectors, -so that, e. g., the Unicode character <cite>MATHEMATICAL SANS-SERIF BOLD -ITALIC CAPITAL A</cite> is selected by the non-mnemonic <tt class="literal">\mathbfsfit{A}</tt>.</p> -</dd> -<dt><a class="reference internal" href="#math-versions">math versions</a></dt> -<dd><p>are not directly supported but easy to emulate.</p> -<p>As Unicode fonts can hold all math symbols in a single font file, a -single <tt class="literal"><span class="pre">\setmathfont[<font</span> <span class="pre">features>]{<font</span> name>}</tt> can replace -the <tt class="literal"><span class="pre">\mathversion{<mathversion>}</span></tt> command if a complete OpenType -math font in the desired version is available.</p> -<p>However, complete OpenType math fonts are rare. Therefore -unicode-math supports using multiple fonts with the <tt class="literal">range</tt> -option. This way one can emulate, e. g., the <tt class="literal">bold</tt> math version -via:</p> -<pre class="literal-block">\renewcommand{\boldmath}{% - \setmathfont{XITS Bold}% - \setmathfont[range={"1D400-"1F020}]{XITS Math}% - \setmathfont[range=\mathup->\mathbfup]{XITS Math}% - \setmathfont[range=\mathsfit->\mathbfsfit]{XITS Math}% - % ... -} -</pre> -<p>It would be nice if unicode-math could provide a <tt class="literal">\newmathversion</tt> -command similar to the <tt class="literal">\newfontfamily</tt> in <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fontspec.html">fontspec</a> for such setups.</p> -<p>For alphanumerical characters, the <tt class="literal">\mathbf</tt>, <tt class="literal">\mathsf</tt>, and -<tt class="literal">\mathsfbf</tt> behave like <a class="reference internal" href="#in-line-math-versions">“in-line math versions”</a>.</p> -</dd> -<dt><a class="reference internal" href="#math-styles">math styles</a></dt> -<dd><p>are supported with the <tt class="literal"><span class="pre">math-style</span></tt> package option that accepts the -values <tt class="literal">TeX</tt>, <tt class="literal">ISO</tt>, <tt class="literal">french</tt>, <tt class="literal">upright</tt>, and <tt class="literal">literal</tt>.</p> -</dd> -</dl> +so that, e. g., the Unicode character MATHEMATICAL SANS-SERIF BOLD +ITALIC CAPITAL A is selected by the non-mnemonic <tt class="literal">\mathbfsfit{A}</tt>.</p> +</li> +<li><p><a class="reference internal" href="#math-versions">Math versions</a> can be set up using the syntax +<tt class="literal"><span class="pre">\setmathfont[version=<version</span> <span class="pre">name>,<font</span> <span class="pre">features>]{<font</span> name>}</tt></p></li> +<li><p>Several <a class="reference internal" href="#math-styles">math styles</a> are supported with the <tt class="literal"><span class="pre">math-style</span></tt> package +option that accepts the values <tt class="literal">TeX</tt>, <tt class="literal">ISO</tt>, <tt class="literal">french</tt>, <tt class="literal">upright</tt>, +and <tt class="literal">literal</tt>.</p></li> +</ul> </div> </div> <div class="section" id="conclusions-and-outlook"> -<h2><a class="toc-backref" href="#id60"><span class="sectnum">4.4</span> Conclusions and outlook</a></h2> -<p>It is hoped, that in the future more fonts families will support the +<h2><a class="toc-backref" href="#id52"><span class="sectnum">4.4</span> Conclusions and outlook</a></h2> +<p>It is hoped, that in the future more font families will support the OML encoding in normal and bold weight as well as upright and italic shape. This would be a major step towards a LaTeX equivalent of the <a class="reference internal" href="#mathematical-alphanumeric-symbols">mathematical alphanumeric symbols</a> Unicode block.</p> <p>This should be (relatively) easy to achieve via virtual fonts when the glyphs for the Greek letters already exist. Examples are Latin Modern, Kerkis, GFS Neohellenic, LX Fonts and KP-Serif.</p> -<p>Alternatively, the T7 encoding could be used for math alphabets (if it -ever happens to materialise).</p> <p>Upright small Greek letters in <tt class="literal">\mathrm</tt> would enable the specification of the constant pi, Myons, Pions, alpha-particles, photons, and neutrinos with <a class="reference internal" href="#math-alphabets">math alphabets</a>. (With <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html">mathdesign</a> @@ -2382,8 +2482,8 @@ users of Unicode-enabled TeX engines (XeTeX or LuaTeX).</p> </div> </div> <div class="section" id="references"> -<h1><a class="toc-backref" href="#id61"><span class="sectnum">5</span> References</a></h1> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id1">[ISO-80000-2]</a></dt> +<h1><a class="toc-backref" href="#id53"><span class="sectnum">5</span> References</a></h1> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id7">[ISO-80000-2]</a></dt> <dd id="iso-80000-2"> <p class="first last"><cite>Quantities and units – Part 2: Mathematical signs and symbols to be used in the natural sciences and technology</cite>: @@ -2395,14 +2495,14 @@ and symbols to be used in the natural sciences and technology</cite>: <p class="first last"><cite>Quantities and units</cite>, Superseded by [ISO-80000].</p> </dd> </dl> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id2">[typefaces]</a></dt> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id1">[typefaces]</a></dt> <dd id="typefaces"> <p class="first last">National Institute of Standards and Technology (<a class="reference external" href="http://physics.nist.gov/">NIST</a>), <cite>Typefaces for Symbols in Scientific Manuscripts</cite>: <a class="reference external" href="http://physics.nist.gov/cuu/pdf/typefaces.pdf">http://physics.nist.gov/cuu/pdf/typefaces.pdf</a>.</p> </dd> </dl> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id3">[checklist]</a></dt> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id2">[checklist]</a></dt> <dd id="checklist"> <p class="first last">National Institute of Standards and Technology (<a class="reference external" href="http://physics.nist.gov/">NIST</a>), <cite>SI Unit rules and style conventions</cite> @@ -2410,7 +2510,7 @@ Check List for Reviewing Manuscripts: <a class="reference external" href="http://physics.nist.gov/cuu/Units/checklist.html">http://physics.nist.gov/cuu/Units/checklist.html</a>.</p> </dd> </dl> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id5">[fonts_for_symbols]</a></dt> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id4">[fonts_for_symbols]</a></dt> <dd id="fonts-for-symbols"> <p class="first last">International Union of Pure and Applied Chemistry (<a class="reference external" href="http://iupac.org/">IUPAC</a>), <cite>On the use of italic and roman fonts for symbols @@ -2418,14 +2518,14 @@ in scientific text</cite>, (Revised December 1999): <a class="reference external" href="http://old.iupac.org/standing/idcns/fonts_for_symbols.html">http://old.iupac.org/standing/idcns/fonts_for_symbols.html</a>.</p> </dd> </dl> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id4">[SI]</a></dt> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id3">[SI]</a></dt> <dd id="si"> <p class="first last">Bureau international des poids et mesures (<a class="reference external" href="http://www.bipm.org/">BIPM</a>), <cite>The International System of Units (SI)</cite>: <a class="reference external" href="http://www.bipm.org/en/si/si_brochure/">http://www.bipm.org/en/si/si_brochure/</a>.</p> </dd> </dl> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id7">[Green-Book]</a></dt> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id6">[Green-Book]</a></dt> <dd id="green-book"> <p class="first last">International Union of Pure and Applied Chemistry (<a class="reference external" href="http://iupac.org/">IUPAC</a>), <cite>Quantities, Units and Symbols in Physical Chemistry</cite>, @@ -2433,14 +2533,21 @@ in scientific text</cite>, (Revised December 1999): [ISBN 0 85404 433 7; ISBN-13 978 0 85404 433 7].</p> </dd> </dl> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id6">[Red-Book]</a></dt> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id5">[Red-Book]</a></dt> <dd id="red-book"> <p class="first last">International Union of Pure and Applied Physics (<a class="reference external" href="http://www.iupap.org/">IUPAP</a>), <cite>Symbols, Units, Nomenclature and Fundamental Constants in Physics</cite>: <a class="reference external" href="http://metrology.wordpress.com/measurement-process-index/iupap-red-book/index-iupap-red-book/">http://metrology.wordpress.com/measurement-process-index/iupap-red-book/index-iupap-red-book/</a>.</p> </dd> </dl> -<dl class="citation"><dt class="label"><a class="fn-backref" href="#id15">[encguide]</a></dt> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id10">[becc97]</a></dt> +<dd id="becc97"> +<p class="first last">Claudio Beccari, <cite>Typesetting mathematics for science and +technology according to ISO 31 XI</cite>, TUGboat, Volume 18, 1997, No. 1: +<a class="reference external" href="http://www.tug.org/TUGboat/tb18-1/tb54becc.pdf">http://www.tug.org/TUGboat/tb18-1/tb54becc.pdf</a>.</p> +</dd> +</dl> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id21">[encguide]</a></dt> <dd id="encguide"> <p class="first last">Frank Mittelbach, Robin Fairbairns, Werner Lemberg, LaTeX3 Project Team, <cite>LaTeX font encodings</cite>: @@ -2449,13 +2556,13 @@ LaTeX3 Project Team, <cite>LaTeX font encodings</cite>: </dl> <dl class="citation"><dt class="label">[fntguide]</dt> <dd id="fntguide"> -<em>(<a class="fn-backref" href="#id10">1</a>, <a class="fn-backref" href="#id11">2</a>)</em> <p class="last">LaTeX3 Project Team, <cite>LaTeX 2e font selection</cite>: +<em>(<a class="fn-backref" href="#id11">1</a>, <a class="fn-backref" href="#id12">2</a>)</em> <p class="last">LaTeX3 Project Team, <cite>LaTeX 2e font selection</cite>: <a class="reference external" href="http://mirror.ctan.org/macros/latex/doc/fntguide.pdf">http://mirror.ctan.org/macros/latex/doc/fntguide.pdf</a>.</p> </dd> </dl> <dl class="citation"><dt class="label">[tr25]</dt> <dd id="tr25"> -<em>(<a class="fn-backref" href="#id16">1</a>, <a class="fn-backref" href="#id17">2</a>)</em> <p class="last">Barbara Beeton, Asmus Freytag, Murray Sargent III, +<em>(<a class="fn-backref" href="#id18">1</a>, <a class="fn-backref" href="#id22">2</a>, <a class="fn-backref" href="#id23">3</a>)</em> <p class="last">Barbara Beeton, Asmus Freytag, Murray Sargent III, <cite>Unicode Support for Mathematics</cite>, Unicode Technical Report #25: <a class="reference external" href="http://www.unicode.org/reports/tr25/">http://www.unicode.org/reports/tr25/</a>.</p> </dd> diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.pdf b/Master/texmf-dist/doc/latex/isomath/isomath.pdf Binary files differindex b91d0a8ef3a..803a6f6fd2a 100644 --- a/Master/texmf-dist/doc/latex/isomath/isomath.pdf +++ b/Master/texmf-dist/doc/latex/isomath/isomath.pdf diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.html b/Master/texmf-dist/doc/latex/isomath/isomath.sty.html index 8d459c5d09e..86244f53e7b 100644 --- a/Master/texmf-dist/doc/latex/isomath/isomath.sty.html +++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.html @@ -3,14 +3,15 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.8: http://docutils.sourceforge.net/" /> -<title>isomath.sty: Math for scientists</title> -<meta name="copyright" content="© 2008, 2010 Günter Milde" /> +<meta name="generator" content="Docutils 0.10: http://docutils.sourceforge.net/" /> +<title>isomath</title> +<meta name="date" content="2012-09-10" /> +<meta name="copyright" content="© 2008, 2012 Günter Milde" /> <style type="text/css"> /* :Author: David Goodger (goodger@python.org) -:Id: $Id: html4css1.css 6511 2011-01-03 14:49:11Z milde $ +:Id: $Id: html4css1.css 7434 2012-05-11 21:06:27Z milde $ :Copyright: This stylesheet has been placed in the public domain. Default cascading style sheet for the HTML output of Docutils. @@ -250,10 +251,18 @@ pre.address { margin-top: 0 ; font: inherit } -pre.literal-block, pre.doctest-block { +pre.literal-block, pre.doctest-block, pre.math, pre.code { margin-left: 2em ; margin-right: 2em } +pre.code .ln { /* line numbers */ + color: grey; +} + +.code { + background-color: #eeeeee +} + span.classifier { font-family: sans-serif ; font-style: oblique } @@ -336,6 +345,8 @@ body { line-height:1.3; /* http://ilovetypography.com/2008/02/28/a-guide-to-web-typography/ recommends "line-spacing that’s at least 140% of your text size" */ + counter-reset: table; + /* counter-reset: figure; */ } /* avoid long lines --> better reading */ @@ -362,7 +373,7 @@ dl.simple, dl.compact, dl.simple > dd, dl.compact > dd { } /* space around paragraphs */ -dl > dd p:first-child { +dl > dd p:first-child, td > p { margin: 0; } @@ -502,15 +513,23 @@ resulting list resembles the list-style 'outside' with a hanging indent. */ /* New ordered list: reset counter, suppress the default label */ -ol { +ol, ol.arabic, ol.loweralpha, ol.upperalpha, +ol.lowerroman, ol.upperroman { counter-reset: item; - list-style-type: none ! important; + list-style: none } /* Set the negative indent of the list label as feature of the list item */ ol > li { text-indent: -40px; /* Mozillas default indent */ } +/* reset for child elements */ +ol > li > * { + text-indent: 0px; + text-indent: 0; + margin-top: 0; + /* background: lightgreen; */ +} /* Label */ ol > li:before { @@ -527,16 +546,6 @@ ol > li:before { /* background: yellow; */ } -/* objects nested in an ol */ -ol > li > p, -ol > li > ol, -ol > li > ul, -ol > li > dl { - text-indent: 0; - margin-top: 0; - /* background: lightgreen; */ -} - /* The list item's first line starts next to the label, without indent */ ol > li > p:first-child, ol > li > ol:first-child, @@ -565,6 +574,12 @@ ol.nested > li:before, ol.nested ol > li:before { content: counters(item, ".") " "; } +/* lists nested in definition list */ + +dd > ul, dd > ol { + padding-left: 0pt; +} + /* TODO: prefix, suffix? */ /* smaller font for super- and subscripts */ @@ -574,18 +589,26 @@ ol.nested > li:before, ol.nested ol > li:before { /* Tables */ /* ====== */ -/* borders for "normal" tables */ +/* margins and borders for "normal" tables */ table { - margin-top: 0.5em ; - margin-bottom: 0.5em; - border-style: outset; +/* background: magenta; */ + margin-top: 1em ; + margin-bottom: 1em; +/* border-style: outset; */ + border-style: solid; + border-color: silver; border-width: thin; - /* border-collapse: collapse; */ + border-collapse: collapse; +} +blockquote > table { + margin-top: 0em ; + margin-bottom: 0em; } td, th { - border-style: inset; + border-style: solid; border-width: thin; + border-color: silver; /* text-align: left; */ padding: 0 1ex; } @@ -607,7 +630,6 @@ table.booktabs { border: 0; border-top: 2px solid; border-bottom: 2px solid; - border-collapse: collapse; } table.booktabs * { @@ -619,30 +641,31 @@ table.booktabs th { table > caption { text-align: left; + margin-bottom: 0.25em /* padding: 2em 0 1em 0; */ } -/* numbered tables and figures*/ -body { - counter-reset: table; -/* counter-reset: figure; */ -} - +/* numbered tables*/ table.numbered > caption:before { - counter-increment: table; + counter-increment: table; /* defined/re-set in body */ content: "Table " counter(table) ": "; font-weight: bold; } -/* whitespace and line-wrapping in inline literals - ----------------------------------------------- +/* literal text + ------------ */ +/* whitespace and wrapping in inline literals */ /* possible values: normal, nowrap, pre, pre-wrap, pre-line */ tt.literal { white-space: pre-wrap; } +/* /* compensate for initial line-break (which is literal with XHTML 1.1) */ */ +/* pre.literal-block, pre.doctest-block { */ +/* margin-top: 0em ; */ +/* } */ /* Table of Contents */ @@ -721,13 +744,6 @@ a.reference.external { /* vertical-align: super; */ /* } */ -dl.field-list { - margin-left: 2em; -} -dl.field-list > dt:after { - content: ""; /* drop trailing ':' */ -} - dl.footnote > dd { margin-left: 1.2em; } @@ -746,29 +762,28 @@ td, th { padding-top: 0.1ex; } -em.bfit { - font-weight: bold; - font-family: serif; -} -em.sfbfit { - font-weight: bold; - font-family: sans-serif; -} +/* let borderless overreide booktab */ +.booktabs.borderless, +table.booktabs.borderless td, table.booktabs.borderless th { + border: 0; + margin-left: 2em; + } -/* no borders for "borderless" tables */ -table.booktabs.borderless, table.booktabs.borderless * { - border-style: none; -} +table.docutils td, table.docutils th, + vertical-align: bottom; } </style> </head> <body> -<div class="document" id="isomath-sty-math-for-scientists"> -<h1 class="title">isomath.sty: Math for scientists</h1> +<div class="document" id="isomath"> +<h1 class="title">isomath</h1> +<h2 class="subtitle" id="mathematical-style-for-science-and-technology">Mathematical style for science and technology</h2> <dl class="docinfo"> +<dt class="date">Date</dt> +<dd class="date">2012-09-10</dd> <dt class="copyright">Copyright</dt> -<dd class="copyright">© 2008, 2010 Günter Milde</dd> +<dd class="copyright">© 2008, 2012 Günter Milde</dd> <dt>Licence</dt> <dd><p>This work may be distributed and/or modified under the conditions of the <a class="reference external" href="http://www.latex-project.org/lppl.txt">LaTeX Project Public License</a>, either @@ -777,73 +792,77 @@ version 1.3 of this license or (at your option) any later version.</p> <dt>Identification</dt> <dd><pre class="literal-block">\NeedsTeXFormat{LaTeX2e} \ProvidesPackage{isomath} -[2011/02/01 v0.5 ISO math style] +[2012/09/04 v0.6.1 ISO math style] </pre> </dd> </dl> <div class="abstract topic"> <p class="topic-title first">Abstract</p> -<p>The <cite>isomath</cite> package enables formatting Greek and Latin -letters as symbols for vectors, matrices, and tensors -in the typefaces recommended for scientific papers -by the International Standard ISO 80000-2.</p> +<p>The <cite>isomath</cite> package provides tools for a mathematical style +that conforms to the International Standard ISO 80000-2 and is +common in science and technology. It changes the default shape of +capital Greek letters to italic, sets up bold italic and +sans-serif bold italic math alphabets with Latin and Greek +characters, and defines macros for markup of vector, matrix and +tensor symbols.</p> </div> <div class="contents topic" id="contents"> <p class="topic-title first">Contents</p> <ul class="simple"> -<li><p><a class="reference internal" href="#history" id="id3">History</a></p></li> -<li><p><a class="reference internal" href="#requirements" id="id4">Requirements</a></p> +<li><p><a class="reference internal" href="#history" id="id4">History</a></p></li> +<li><p><a class="reference internal" href="#requirements" id="id5">Requirements</a></p> <ul> -<li><p><a class="reference internal" href="#fixmath-sty" id="id5">fixmath.sty</a></p></li> -<li><p><a class="reference internal" href="#kvoptions-sty" id="id6">kvoptions.sty</a></p></li> +<li><p><a class="reference internal" href="#fixmath-sty" id="id6">fixmath.sty</a></p></li> +<li><p><a class="reference internal" href="#kvoptions-sty" id="id7">kvoptions.sty</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#options" id="id7">Options</a></p> +<li><p><a class="reference internal" href="#options" id="id8">Options</a></p> <ul> -<li><p><a class="reference internal" href="#rmdefault" id="id8">rmdefault</a></p></li> -<li><p><a class="reference internal" href="#sfdefault" id="id9">sfdefault</a></p></li> -<li><p><a class="reference internal" href="#scaled" id="id10">scaled</a></p></li> -<li><p><a class="reference internal" href="#reusemathalphabets" id="id11">reuseMathAlphabets</a></p></li> -<li><p><a class="reference internal" href="#omlmath" id="id12">OMLmath*</a></p></li> +<li><p><a class="reference internal" href="#rmdefault" id="id9">rmdefault</a></p></li> +<li><p><a class="reference internal" href="#sfdefault" id="id10">sfdefault</a></p></li> +<li><p><a class="reference internal" href="#scaled" id="id11">scaled</a></p></li> +<li><p><a class="reference internal" href="#reusemathalphabets" id="id12">reuseMathAlphabets</a></p></li> +<li><p><a class="reference internal" href="#omlmath" id="id13">OMLmath*</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#declarations" id="id13">Declarations</a></p> +<li><p><a class="reference internal" href="#declarations" id="id14">Declarations</a></p> <ul> -<li><p><a class="reference internal" href="#math-alphabets" id="id14">Math alphabets</a></p> +<li><p><a class="reference internal" href="#math-alphabets" id="id15">Math alphabets</a></p> <ul> -<li><p><a class="reference internal" href="#mathbfit" id="id15">mathbfit</a></p></li> -<li><p><a class="reference internal" href="#mathsfit" id="id16">mathsfit</a></p></li> -<li><p><a class="reference internal" href="#mathsfbfit" id="id17">mathsfbfit</a></p></li> -<li><p><a class="reference internal" href="#redefine-standard-alphabets" id="id18">Redefine standard alphabets</a></p></li> +<li><p><a class="reference internal" href="#mathbfit" id="id16">mathbfit</a></p></li> +<li><p><a class="reference internal" href="#mathsfit" id="id17">mathsfit</a></p></li> +<li><p><a class="reference internal" href="#mathsfbfit" id="id18">mathsfbfit</a></p></li> +<li><p><a class="reference internal" href="#redefine-standard-alphabets" id="id19">Redefine standard alphabets</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#command-aliases" id="id19">Command aliases</a></p> +<li><p><a class="reference internal" href="#command-aliases" id="id20">Command aliases</a></p> <ul> -<li><p><a class="reference internal" href="#vectorsym" id="id20">\vectorsym</a></p></li> -<li><p><a class="reference internal" href="#matrixsym" id="id21">\matrixsym</a></p></li> -<li><p><a class="reference internal" href="#tensorsym" id="id22">\tensorsym</a></p></li> +<li><p><a class="reference internal" href="#vectorsym" id="id21">\vectorsym</a></p></li> +<li><p><a class="reference internal" href="#matrixsym" id="id22">\matrixsym</a></p></li> +<li><p><a class="reference internal" href="#tensorsym" id="id23">\tensorsym</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#font-mappings" id="id23">Font mappings</a></p> +<li><p><a class="reference internal" href="#font-setup-fixes" id="id24">Font setup fixes</a></p> <ul> -<li><p><a class="reference internal" href="#common-family-name-for-text-and-math" id="id24">Common family name for text and math</a></p></li> -<li><p><a class="reference internal" href="#scaling" id="id25">Scaling</a></p></li> +<li><p><a class="reference internal" href="#unknown-makro-in-font-definition-file" id="id25">Unknown makro in font definition file</a></p></li> +<li><p><a class="reference internal" href="#common-family-name-for-text-and-math-fonts" id="id26">Common family name for text and math fonts</a></p></li> +<li><p><a class="reference internal" href="#scaling" id="id27">Scaling</a></p></li> </ul> </li> </ul> </li> -<li><p><a class="reference internal" href="#references" id="id26">References</a></p></li> +<li><p><a class="reference internal" href="#references" id="id28">References</a></p></li> </ul> </div> <div class="section" id="history"> -<h1><a class="toc-backref" href="#id3">History</a></h1> +<h1><a class="toc-backref" href="#id4">History</a></h1> <table class="borderless booktabs numbered align-left"> <colgroup> -<col width="4%" /> -<col width="17%" /> -<col width="79%" /> +<col width="7%" /> +<col width="15%" /> +<col width="78%" /> </colgroup> -<tbody valign="top"> +<tbody> <tr><td><p>0.1</p></td> <td><p>2008-09-25</p></td> <td><p>first public version.</p></td> @@ -904,24 +923,32 @@ by the International Standard ISO 80000-2.</p> <td> </td> <td><p>upright numbers with <tt class="literal">\vectorsym</tt>.</p></td> </tr> +<tr><td><p>0.6</p></td> +<td><p>2012-09-10</p></td> +<td><p>Scaling for Kepler Sans (<tt class="literal">sfdefault=jkpss</tt>);</p></td> +</tr> +<tr><td><p></p></td> +<td> </td> +<td><p>documentation update, new caption and abstract.</p></td> +</tr> </tbody> </table> </div> <div class="section" id="requirements"> -<h1><a class="toc-backref" href="#id4">Requirements</a></h1> +<h1><a class="toc-backref" href="#id5">Requirements</a></h1> <div class="section" id="fixmath-sty"> -<h2><a class="toc-backref" href="#id5">fixmath.sty</a></h2> +<h2><a class="toc-backref" href="#id6">fixmath.sty</a></h2> <p>The package <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixmath.html">fixmath</a> by Walter Schmidt defines Greek letters as symbols -of type <tt class="literal">\mathalpha</tt> and takes them from the <tt class="literal">letters</tt> SymbolFont in +of type <tt class="literal">\mathalpha</tt> and takes them from the <tt class="literal">letters</tt> symbol font in <tt class="literal">\mathnormal</tt> (as opposed to <tt class="literal">operators</tt> in <tt class="literal">fontmath.ltx</tt>).</p> -<p><a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixmath.html">fixmath</a> also defines the <tt class="literal">\mathbold</tt> alphabet, setting it to <tt class="literal">cmm</tt>. -This definition will be overwritten with a configurable value for -the font family below.</p> +<p><cite>fixmath</cite> also defines the <tt class="literal">\mathbold</tt> alphabet, setting it to <tt class="literal">cmm</tt>. +<cite>isomath</cite> overwrites this definition with a configurable value for +the font family.</p> <pre class="literal-block">\RequirePackage{fixmath} </pre> </div> <div class="section" id="kvoptions-sty"> -<h2><a class="toc-backref" href="#id6">kvoptions.sty</a></h2> +<h2><a class="toc-backref" href="#id7">kvoptions.sty</a></h2> <p>The <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kvoptions.html">kvoptions</a> package in the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/oberdiek.html">oberdiek</a> bundle facilitates the setup of package options and provides a key=value interface (based on <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/keyval.html">keyval</a>):</p> <pre class="literal-block">\RequirePackage{kvoptions} @@ -929,9 +956,9 @@ package options and provides a key=value interface (based on <a class="reference </div> </div> <div class="section" id="options"> -<h1><a class="toc-backref" href="#id7">Options</a></h1> +<h1><a class="toc-backref" href="#id8">Options</a></h1> <div class="section" id="rmdefault"> -<h2><a class="toc-backref" href="#id8">rmdefault</a></h2> +<h2><a class="toc-backref" href="#id9">rmdefault</a></h2> <p>Family for roman math fonts. Must be available in OML encoding. The default is to use the corresponding text font family (<tt class="literal">\rmdefault</tt>).</p> @@ -939,21 +966,22 @@ encoding. The default is to use the corresponding text font family </pre> </div> <div class="section" id="sfdefault"> -<h2><a class="toc-backref" href="#id9">sfdefault</a></h2> +<h2><a class="toc-backref" href="#id10">sfdefault</a></h2> <p>Family for sans-serif math fonts. The default selects <cite>CM Bright</cite>, as most sans serif fonts are not available in OML encoding:</p> <pre class="literal-block">\DeclareStringOption[cmbr]{sfdefault} </pre> </div> <div class="section" id="scaled"> -<h2><a class="toc-backref" href="#id10">scaled</a></h2> -<p>The sans-serif fonts, <tt class="literal">fav</tt> (Arev), <tt class="literal">llcmss</tt> (LX Fonts), and -<tt class="literal">iwona</tt> can be scaled with the <tt class="literal">scaled</tt> option.</p> +<h2><a class="toc-backref" href="#id11">scaled</a></h2> +<p>The sans-serif fonts, <tt class="literal">fav</tt> (Arev), <tt class="literal">llcmss</tt> (LX Fonts), +<tt class="literal">jkpss</tt> (Kepler Serif) and <tt class="literal">iwona</tt> can be scaled +with the <tt class="literal">scaled</tt> option.</p> <pre class="literal-block">\DeclareStringOption[1.0]{scaled} </pre> </div> <div class="section" id="reusemathalphabets"> -<h2><a class="toc-backref" href="#id11">reuseMathAlphabets</a></h2> +<h2><a class="toc-backref" href="#id12">reuseMathAlphabets</a></h2> <p>The definition of new <a class="reference internal" href="#math-alphabets">math alphabets</a> can lead to a “too many math alphabets used in version normal” error.</p> <p>As a workaround, this option tells <cite>isomath</cite> to re-use the existing @@ -963,7 +991,7 @@ bold.</p> </pre> </div> <div class="section" id="omlmath"> -<h2><a class="toc-backref" href="#id12">OMLmath*</a></h2> +<h2><a class="toc-backref" href="#id13">OMLmath*</a></h2> <p>The following options cause <cite>isomath</cite> to (re)define the corresponding <a class="reference internal" href="#math-alphabets">math alphabets</a> in OML encoding:</p> <pre class="literal-block">\DeclareBoolOption{OMLmathrm} @@ -974,10 +1002,10 @@ bold.</p> % backwards compatibility option alias \DeclareVoidOption{OMLmathsans}{\isomath@OMLmathsfittrue} </pre> -<p>Setting these options enables access to small Greek letters in -different shapes with e.g. <tt class="literal"><span class="pre">\mathrm{\pi}</span></tt> <em>if an OML encoded font -is available</em>. Currently, only the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html">mathdesign</a> fonts support roman in -OML encoding.</p> +<p>Setting these options enables access to small Greek letters in different +shapes with e.g. <tt class="literal"><span class="pre">\mathrm{\pi}</span></tt> but only <em>if an OML encoded font is +available</em>. Currently, only the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html">mathdesign</a> fonts support roman in OML +encoding.</p> <p>With some packages, these options can result in a “too many math alphabets used in version normal” error.</p> <hr class="docutils" /> @@ -987,16 +1015,16 @@ used in version normal” error.</p> </div> </div> <div class="section" id="declarations"> -<h1><a class="toc-backref" href="#id13">Declarations</a></h1> +<h1><a class="toc-backref" href="#id14">Declarations</a></h1> <div class="section" id="math-alphabets"> -<h2><a class="toc-backref" href="#id14">Math alphabets</a></h2> +<h2><a class="toc-backref" href="#id15">Math alphabets</a></h2> <p>In math, LaTeX uses “absolute” fontnames instead of a selection by family, shape, and weight because typefaces have a semantic meaning <a class="citation-reference" href="#fntguide" id="id1">[fntguide]</a>.</p> <p><cite>isomath</cite> defines a math alphabet for every required font variant and optionally re-defines the standard math alphabets in <cite>OML</cite> font encoding.</p> <p>Unfortunately, the number of math alphabets in one math version is -limited to 16, so we have to be carefull not to exceed this. The +limited to 16, so we have to be careful not to exceed this. The <tt class="literal">reuseMathAlphabets</tt> option reduces the number of math alphabet definitions by two, with the side effect of italic shape with <tt class="literal">\mathbf</tt> and <tt class="literal">\mathsf</tt> commands:</p> @@ -1008,7 +1036,7 @@ definitions by two, with the side effect of italic shape with \fi </pre> <div class="section" id="mathbfit"> -<h3><a class="toc-backref" href="#id15">mathbfit</a></h3> +<h3><a class="toc-backref" href="#id16">mathbfit</a></h3> <p>The <em>bold italic</em> math alphabet is named <tt class="literal">\mathbfit</tt> like in <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/unicode-math.html">unicode-math</a> (with an alias <tt class="literal">\mathbold</tt> like in <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixmath.html">fixmath</a> and related packages). With the <a class="reference internal" href="#reusemathalphabets">reuseMathAlphabets</a> option, the roman bold @@ -1024,11 +1052,11 @@ distinguishing between <tt class="literal">b</tt> and <tt class="literal">bx</tt \fi </pre> <p>alias (overwriting the definition from fixmath):</p> -<pre class="literal-block">\renewcommand{\mathbold}{\mathbfit} +<pre class="literal-block">\renewcommand*{\mathbold}{\mathbfit} </pre> </div> <div class="section" id="mathsfit"> -<h3><a class="toc-backref" href="#id16">mathsfit</a></h3> +<h3><a class="toc-backref" href="#id17">mathsfit</a></h3> <p>For <em>sans-serif italic</em>, we define a new alphabet <tt class="literal">\mathsfit</tt> (with the alias <tt class="literal">\mathsans</tt> in analogy to <tt class="literal">\mathbold</tt>). As this typeface is not required by ISO 80000-2 and TeX limits the number of math alphabets @@ -1042,9 +1070,9 @@ to 16 per math version, it is only defined if the <tt class="literal">OMLmathsfi </pre> </div> <div class="section" id="mathsfbfit"> -<h3><a class="toc-backref" href="#id17">mathsfbfit</a></h3> +<h3><a class="toc-backref" href="#id18">mathsfbfit</a></h3> <p>The <em>sans serif bold italic</em> alphabet is used for tensor symbols. -Following the Unicode math name scheme it is called +Following the Unicode naming scheme it is called <tt class="literal"><span class="pre">\mathsfbfit``(with</span> the backwards compatibility alias <span class="pre">``\mathboldsans</span></tt>). With the <a class="reference internal" href="#reusemathalphabets">reuseMathAlphabets</a> option, the upright sans serif math alphabet <tt class="literal">\mathsf</tt> is redefined and <tt class="literal">\mathsfbfit</tt> made an @@ -1059,7 +1087,7 @@ alias to it:</p> </pre> </div> <div class="section" id="redefine-standard-alphabets"> -<h3><a class="toc-backref" href="#id18">Redefine standard alphabets</a></h3> +<h3><a class="toc-backref" href="#id19">Redefine standard alphabets</a></h3> <p>Redefine standard alphabets in <cite>OML</cite> font encoding if the corresponding <a class="reference internal" href="#omlmath">OMLmath*</a> option is true:</p> <pre class="literal-block">\ifisomath@OMLmathrm @@ -1081,16 +1109,15 @@ if the corresponding <a class="reference internal" href="#omlmath">OMLmath*</a> </div> </div> <div class="section" id="command-aliases"> -<h2><a class="toc-backref" href="#id19">Command aliases</a></h2> +<h2><a class="toc-backref" href="#id20">Command aliases</a></h2> <p>The following macros allow semantic markup of mathematical symbols. The argument is typeset as proposed by ISO 80000-2 and <a class="reference external" href="http://physics.nist.gov/cuu/pdf/typefaces.pdf">Typefaces for Symbols in Scientific Manuscripts</a>.</p> <div class="section" id="vectorsym"> -<h3><a class="toc-backref" href="#id20">\vectorsym</a></h3> +<h3><a class="toc-backref" href="#id21">\vectorsym</a></h3> <p>Alphabetic vectors symbols are typeset <em>boldface italic</em> while numeric ones (e.g. zero vector) are typeset <em>boldface upright</em>. The number -test is a simplified version from the LaTeX FAQ -<a class="reference external" href="http://mail.tug.org/texlive/Contents/live/texmf-dist/doc/generic/FAQ-en/html/FAQ-isitanum.html">Is the argument a number?</a> +test is a simplified version from the LaTeX FAQ "<a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=isitanum">Is the argument a number?</a>" It fails if a number is followed by a non-number, e.g. <tt class="literal">\vectorsym{1a}</tt>, but this is no valid vector symbol and would look strange with the <tt class="literal">\vec</tt> accent, too.</p> @@ -1106,26 +1133,34 @@ you might want to re-define the standard <tt class="literal">\vec</tt> command a package.</p> </div> <div class="section" id="matrixsym"> -<h3><a class="toc-backref" href="#id21">\matrixsym</a></h3> +<h3><a class="toc-backref" href="#id22">\matrixsym</a></h3> <p>Symbols for matrices are typeset <em>boldface italic</em>, i. e. in the same face as vectors.</p> <pre class="literal-block">\providecommand*{\matrixsym}{\vectorsym} </pre> </div> <div class="section" id="tensorsym"> -<h3><a class="toc-backref" href="#id22">\tensorsym</a></h3> +<h3><a class="toc-backref" href="#id23">\tensorsym</a></h3> <p>Symbols for tensors are <em>sans-serif bold italic</em>:</p> <pre class="literal-block">\providecommand*{\tensorsym}{\mathsfbfit} </pre> </div> </div> -<div class="section" id="font-mappings"> -<h2><a class="toc-backref" href="#id23">Font mappings</a></h2> +<div class="section" id="font-setup-fixes"> +<h2><a class="toc-backref" href="#id24">Font setup fixes</a></h2> <p>Substitutions needed for the math alphabet definitions and setup for scaled fonts. For details about the font definition macros see -<a class="citation-reference" href="#fntguide" id="id2">[fntguide]</a>.</p> -<div class="section" id="common-family-name-for-text-and-math"> -<h3><a class="toc-backref" href="#id24">Common family name for text and math</a></h3> +<a class="citation-reference" href="#fntguide" id="id3">[fntguide]</a>.</p> +<div class="section" id="unknown-makro-in-font-definition-file"> +<h3><a class="toc-backref" href="#id25">Unknown makro in font definition file</a></h3> +<p>The <cite>Kepler Sans</cite> font definition file <tt class="literal">omljkpss.fd</tt> contains a boolean +that is defined in <tt class="literal">kpfonts.sty</tt>. This leads to errors if the fonts are +used from another package. Provide a dummy definition:</p> +<pre class="literal-block">\newif\ifkp@upRm +</pre> +</div> +<div class="section" id="common-family-name-for-text-and-math-fonts"> +<h3><a class="toc-backref" href="#id26">Common family name for text and math fonts</a></h3> <p>Some font packages provide matching text and math font but do not define a substitution in their <tt class="literal">*.fd</tt> files. Ideally, the following mappings should be moved there.</p> @@ -1136,35 +1171,40 @@ mappings should be moved there.</p> </pre> </div> <div class="section" id="scaling"> -<h3><a class="toc-backref" href="#id25">Scaling</a></h3> -<p>Scale the <tt class="literal">fav</tt> (Arev), <tt class="literal">llcmss</tt> (LX Fonts), and <tt class="literal">iwona</tt> fonts -by the value of the <a class="reference internal" href="#scaled">scaled</a> option.</p> +<h3><a class="toc-backref" href="#id27">Scaling</a></h3> +<p>Scale the <tt class="literal">fav</tt> (Arev), <tt class="literal">iwona</tt>, <tt class="literal">jkpss</tt> (Kepler Sans) and +<tt class="literal">llcmss</tt> (LX Fonts) sans serif fonts by the value of the <a class="reference internal" href="#scaled">scaled</a> option.</p> <p>To get scaled versions of a font, you cannot use the <tt class="literal">ssub</tt> <cite>size function</cite>, but must use the empty function or <tt class="literal">s</tt> with the font file as argument [found by experiment, GM 2010-01-28].</p> -<p>Arev (see omlzavm.fd): fav ↔ zavm</p> +<p>Arev (see <tt class="literal">omlzavm.fd</tt>) fav ↔ zavm:</p> <pre class="literal-block">\DeclareFontFamily{OML}{fav}{\skewchar\font127} \DeclareFontShape{OML}{fav}{m}{it}{<-> s * [\isomath@scaled] zavmri7m}{} \DeclareFontShape{OML}{fav}{bx}{it}{<-> s * [\isomath@scaled] zavmbi7m}{} </pre> -<p>LX Fonts (see lxfonts.sty): llcmss ↔ llcmm</p> -<pre class="literal-block">\DeclareFontFamily{OML}{llcmss}{\skewchar\font'177} -\DeclareFontShape{OML}{llcmss}{m}{it}{<-> s * [\isomath@scaled] lcmmi8}{} -\DeclareFontShape{OML}{llcmss}{bx}{it}{<-> s * [\isomath@scaled] lcmmib8}{} -</pre> -<p>Ivona (see <tt class="literal">omliwona.fd</tt>) iwona ↔ mi-iwona:</p> +<p>Iwona (see <tt class="literal">omliwona.fd</tt>) iwona ↔ mi-iwona:</p> <pre class="literal-block">\DeclareFontFamily{OML}{iwona}{} \DeclareFontShape{OML}{iwona}{m}{it}{<-> s * [\isomath@scaled] mi-iwonari}{} \DeclareFontShape{OML}{iwona}{bx}{it}{<-> s * [\isomath@scaled] mi-iwonabi}{} </pre> +<p>Kepler Serif (see <tt class="literal">omljkpss.fd</tt>):</p> +<pre class="literal-block">\DeclareFontFamily{OML}{jkpss}{\skewchar\font127 } +\DeclareFontShape{OML}{jkpss}{m}{it}{<-> s * [\isomath@scaled] jkpssmi}{} +\DeclareFontShape{OML}{jkpss}{bx}{it}{<-> s * [\isomath@scaled] jkpssbmi}{} +</pre> +<p>LX Fonts (see <tt class="literal">lxfonts.sty</tt>) llcmss ↔ llcmm:</p> +<pre class="literal-block">\DeclareFontFamily{OML}{llcmss}{\skewchar\font'177} +\DeclareFontShape{OML}{llcmss}{m}{it}{<-> s * [\isomath@scaled] lcmmi8}{} +\DeclareFontShape{OML}{llcmss}{bx}{it}{<-> s * [\isomath@scaled] lcmmib8}{} +</pre> </div> </div> </div> <div class="section" id="references"> -<h1><a class="toc-backref" href="#id26">References</a></h1> +<h1><a class="toc-backref" href="#id28">References</a></h1> <dl class="citation"><dt class="label">[fntguide]</dt> <dd id="fntguide"> -<em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id2">2</a>)</em> <p class="last"><cite>LaTeX 2e font selection</cite>: +<em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id3">2</a>)</em> <p class="last"><cite>LaTeX 2e font selection</cite>: <a class="reference external" href="http://mirror.ctan.org/macros/latex/doc/fntguide.pdf">http://mirror.ctan.org/macros/latex/doc/fntguide.pdf</a>.</p> </dd> </dl> diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt b/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt index df34d12eee9..bff05720225 100644 --- a/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt +++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt @@ -1,47 +1,55 @@ -isomath.sty: Math for scientists -******************************** +isomath +******* +Mathematical style for science and technology +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -:Abstract: The `isomath` package enables formatting Greek and Latin - letters as symbols for vectors, matrices, and tensors - in the typefaces recommended for scientific papers - by the International Standard ISO 80000-2. - -:Copyright: © 2008, 2010 Günter Milde +:Date: 2012-09-10 +:Copyright: © 2008, 2012 Günter Milde :Licence: This work may be distributed and/or modified under the conditions of the `LaTeX Project Public License`_, either version 1.3 of this license or (at your option) any later version. +:Abstract: The `isomath` package provides tools for a mathematical style + that conforms to the International Standard ISO 80000-2 and is + common in science and technology. It changes the default shape of + capital Greek letters to italic, sets up bold italic and + sans-serif bold italic math alphabets with Latin and Greek + characters, and defines macros for markup of vector, matrix and + tensor symbols. + :Identification: :: \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{isomath} - [2011/02/01 v0.5 ISO math style] + [2012/09/04 v0.6.1 ISO math style] .. contents:: - + History ======= .. class:: borderless -=== ============ ======================================================== -0.1 2008-09-25 first public version. -0.2 2008-10-02 bugfix: a usage example was uncommented; +===== =========== ======================================================== +0.1 2008-09-25 first public version. +0.2 2008-10-02 bugfix: a usage example was uncommented; \ updated documentation; \ define \mathsans only if OMLmathsans is true; \ option reuseMathalphabets -> reuseMathAlphabets. -0.3 2009-06-19 documentation update; +0.3 2009-06-19 documentation update; \ fix OMLmathrm and OMLmathsans definitions; \ switch license to LPP. -0.4 2010-08-23 split user documentation from literate source; +0.4 2010-08-23 split user documentation from literate source; \ option ``scaled``; \ documentation update. -0.5 2011-01-04 math alphabet names matching Unicode; +0.5 2011-01-04 math alphabet names matching Unicode; \ documentation review and extension; \ bold alphabet variants in ``bold`` math version; \ upright numbers with ``\vectorsym``. -=== ============ ======================================================== +0.6 2012-09-10 Scaling for Kepler Sans (``sfdefault=jkpss``); +\ documentation update, new caption and abstract. +===== =========== ======================================================== Requirements @@ -53,9 +61,9 @@ The package fixmath_ by Walter Schmidt defines Greek letters as symbols of type ``\mathalpha`` and takes them from the ``letters`` symbol font in ``\mathnormal`` (as opposed to ``operators`` in ``fontmath.ltx``). -fixmath_ also defines the ``\mathbold`` alphabet, setting it to ``cmm``. -This definition is be overwritten with a configurable value for -the font family below. :: +`fixmath` also defines the ``\mathbold`` alphabet, setting it to ``cmm``. +`isomath` overwrites this definition with a configurable value for +the font family. :: \RequirePackage{fixmath} @@ -75,8 +83,7 @@ rmdefault --------- Family for roman math fonts. Must be available in OML encoding. The default is to use the corresponding text font family -(``\rmdefault``). -:: +(``\rmdefault``). :: \DeclareStringOption[\rmdefault]{rmdefault} @@ -89,9 +96,9 @@ most sans serif fonts are not available in OML encoding:: scaled ------ -The sans-serif fonts, ``fav`` (Arev), ``llcmss`` (LX Fonts), and -``iwona`` can be scaled with the ``scaled`` option. -:: +The sans-serif fonts, ``fav`` (Arev), ``llcmss`` (LX Fonts), +``jkpss`` (Kepler Serif) and ``iwona`` can be scaled +with the ``scaled`` option. :: \DeclareStringOption[1.0]{scaled} @@ -102,8 +109,7 @@ alphabets used in version normal” error. As a workaround, this option tells `isomath` to re-use the existing ``\mathbf`` and ``\mathsf`` alphabets for *italic* bold and sans-serif -bold. -:: +bold. :: \DeclareBoolOption{reuseMathAlphabets} @@ -120,10 +126,10 @@ The following options cause `isomath` to (re)define the corresponding % backwards compatibility option alias \DeclareVoidOption{OMLmathsans}{\isomath@OMLmathsfittrue} -Setting these options enables access to small Greek letters in -different shapes with e.g. ``\mathrm{\pi}`` *if an OML encoded font -is available*. Currently, only the mathdesign_ fonts support roman in -OML encoding. +Setting these options enables access to small Greek letters in different +shapes with e.g. ``\mathrm{\pi}`` but only *if an OML encoded font is +available*. Currently, only the mathdesign_ fonts support roman in OML +encoding. With some packages, these options can result in a “too many math alphabets used in version normal” error. @@ -180,7 +186,7 @@ distinguishing between ``b`` and ``bx``?) :: alias (overwriting the definition from fixmath):: - \renewcommand{\mathbold}{\mathbfit} + \renewcommand*{\mathbold}{\mathbfit} mathsfit ~~~~~~~~ @@ -199,7 +205,7 @@ to 16 per math version, it is only defined if the ``OMLmathsfit`` or mathsfbfit ~~~~~~~~~~~~ The *sans serif bold italic* alphabet is used for tensor symbols. -Following the Unicode math name scheme it is called +Following the Unicode naming scheme it is called ``\mathsfbfit``(with the backwards compatibility alias ``\mathboldsans``). With the reuseMathAlphabets_ option, the upright sans serif math alphabet ``\mathsf`` is redefined and ``\mathsfbfit`` made an @@ -246,9 +252,7 @@ The argument is typeset as proposed by ISO 80000-2 and ~~~~~~~~~~~ Alphabetic vectors symbols are typeset *boldface italic* while numeric ones (e.g. zero vector) are typeset *boldface upright*. The number -test is a simplified version from the LaTeX FAQ -`Is the argument a number? -<http://mail.tug.org/texlive/Contents/live/texmf-dist/doc/generic/FAQ-en/html/FAQ-isitanum.html>`__ +test is a simplified version from the LaTeX FAQ "`Is the argument a number?`__" It fails if a number is followed by a non-number, e.g. ``\vectorsym{1a}``, but this is no valid vector symbol and would look strange with the ``\vec`` accent, too. :: @@ -264,6 +268,8 @@ For easier writing or to make existing documents conform to the standard, you might want to re-define the standard ``\vec`` command after loading this package. +__ http://www.tex.ac.uk/cgi-bin/texfaq2html?label=isitanum + \\matrixsym ~~~~~~~~~~~ Symbols for matrices are typeset *boldface italic*, i. e. in the same face @@ -278,16 +284,24 @@ Symbols for tensors are *sans-serif bold italic*:: \providecommand*{\tensorsym}{\mathsfbfit} -Font mappings -------------- +Font setup fixes +---------------- Substitutions needed for the math alphabet definitions and setup for scaled fonts. For details about the font definition macros see [fntguide]_. -Common family name for text and math -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Unknown makro in font definition file +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The `Kepler Sans` font definition file ``omljkpss.fd`` contains a boolean +that is defined in ``kpfonts.sty``. This leads to errors if the fonts are +used from another package. Provide a dummy definition:: + \newif\ifkp@upRm + + +Common family name for text and math fonts +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Some font packages provide matching text and math font but do not define a substitution in their ``*.fd`` files. Ideally, the following mappings should be moved there. @@ -301,31 +315,37 @@ Mathpazo (Palatino) ppl ↔ zplm :: Scaling ~~~~~~~ -Scale the ``fav`` (Arev), ``llcmss`` (LX Fonts), and ``iwona`` fonts -by the value of the scaled_ option. +Scale the ``fav`` (Arev), ``iwona``, ``jkpss`` (Kepler Sans) and +``llcmss`` (LX Fonts) sans serif fonts by the value of the scaled_ option. To get scaled versions of a font, you cannot use the ``ssub`` `size function`, but must use the empty function or ``s`` with the font file as argument [found by experiment, GM 2010-01-28]. -Arev (see omlzavm.fd): fav ↔ zavm :: +Arev (see ``omlzavm.fd``) fav ↔ zavm:: \DeclareFontFamily{OML}{fav}{\skewchar\font127} \DeclareFontShape{OML}{fav}{m}{it}{<-> s * [\isomath@scaled] zavmri7m}{} \DeclareFontShape{OML}{fav}{bx}{it}{<-> s * [\isomath@scaled] zavmbi7m}{} -LX Fonts (see lxfonts.sty): llcmss ↔ llcmm :: - - \DeclareFontFamily{OML}{llcmss}{\skewchar\font'177} - \DeclareFontShape{OML}{llcmss}{m}{it}{<-> s * [\isomath@scaled] lcmmi8}{} - \DeclareFontShape{OML}{llcmss}{bx}{it}{<-> s * [\isomath@scaled] lcmmib8}{} - Iwona (see ``omliwona.fd``) iwona ↔ mi-iwona:: \DeclareFontFamily{OML}{iwona}{} \DeclareFontShape{OML}{iwona}{m}{it}{<-> s * [\isomath@scaled] mi-iwonari}{} \DeclareFontShape{OML}{iwona}{bx}{it}{<-> s * [\isomath@scaled] mi-iwonabi}{} +Kepler Serif (see ``omljkpss.fd``):: + + \DeclareFontFamily{OML}{jkpss}{\skewchar\font127 } + \DeclareFontShape{OML}{jkpss}{m}{it}{<-> s * [\isomath@scaled] jkpssmi}{} + \DeclareFontShape{OML}{jkpss}{bx}{it}{<-> s * [\isomath@scaled] jkpssbmi}{} + +LX Fonts (see ``lxfonts.sty``) llcmss ↔ llcmm:: + + \DeclareFontFamily{OML}{llcmss}{\skewchar\font'177} + \DeclareFontShape{OML}{llcmss}{m}{it}{<-> s * [\isomath@scaled] lcmmi8}{} + \DeclareFontShape{OML}{llcmss}{bx}{it}{<-> s * [\isomath@scaled] lcmmib8}{} + References ========== diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.txt b/Master/texmf-dist/doc/latex/isomath/isomath.txt index 23100dcacfe..f91e12e6678 100644 --- a/Master/texmf-dist/doc/latex/isomath/isomath.txt +++ b/Master/texmf-dist/doc/latex/isomath/isomath.txt @@ -1,22 +1,26 @@ .. -*- rst-mode -*- -isomath: Math for scientists -**************************** +isomath +******* +Mathematical style for science and technology +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :Author: Günter Milde -:Date: 2011-01-14 -:Copyright: © 2008, 2011 Günter Milde +:Date: 2012-09-10 +:Copyright: © 2008, 2012 Günter Milde :Licence: This work may be distributed and/or modified under the conditions of the `LaTeX Project Public License`_, either version 1.3 of this license or (at your option) any later version. -:Abstract: The `isomath` package sets up an “ISO math style” allowing the - use of Greek and Latin letters as symbols for scalars, - vectors, matrices, and tensors in the typefaces recommended - for scientific papers by the International Standard - ISO 80000-2. +:Abstract: The `isomath` package provides tools for a mathematical style + that conforms to the International Standard ISO 80000-2 and is + common in science and technology. It changes the default shape of + capital Greek letters to italic, sets up bold italic and + sans-serif bold italic math alphabets with Latin and Greek + characters, and defines macros for markup of vector, matrix and + tensor symbols. -.. contents:: +.. contents:: :depth: 2 .. sectnum:: @@ -24,121 +28,122 @@ Features -------- .. How do you write the stress tensor ``$\sigma$`` in a - `sans-serif bold italic` typeface, as recommended by [typefaces]_? - -Leading international scientific organisations recommend math layout -rules in line with the International Standard [ISO-80000-2]_ in their -style guides, e. g., [typefaces]_, [checklist]_, [SI]_, [fonts_for_symbols]_, -[Red-Book]_, [Green-Book]_: - -* The overall rule is that symbols representing physical quantities - (or variables) are italic, but symbols representing units, or - labels, are roman. - -* Symbols for vectors are boldface italic, symbols for tensors are - sans-serif bold italic, and symbols for matrices are boldface - italic. - -* The above rules apply equally to letter symbols from both the Greek - and the Latin alphabet. - -The traditional TeX `math style`_ deviates from this rules in some + *sans-serif bold italic* typeface, as recommended by [typefaces]_? + +In their style guides, e. g. [typefaces]_, [checklist]_, [SI]_, +[fonts_for_symbols]_, [Red-Book]_, [Green-Book]_, many international +scientific organisations recommend layout rules for mathematics in line with +the International Standard [ISO-80000-2]_. + +.. admonition:: International standard layout rules + + * The overall rule is that symbols representing physical quantities + (or variables) are italic, but symbols representing units, or + labels, are roman. + + * Symbols for vectors and matrices are bold italic, symbols for tensors + are sans-serif bold italic. + + * The above rules apply equally to letter symbols from the Greek and the + Latin alphabet. + +.. The recommendations in this standard are intended mainly for use in the + natural sciences and technology, but also apply to other areas where + mathematics is used. + +TeX's default mathematical style deviates from this rules in several points: -* capital Greek letters default to upright shape, +* Capital Greek letters default to upright shape, * small Greek letters are excluded from font changes with the `math - alphabets`_. + alphabet`_ commands, and -* The ``\vec`` command produces an arrow accent. +* the ``\vec`` command produces an arrow accent. -The `isomath` package implements an `ISO math style`_ and provides -`new math alphabets`_ with bold italic and sans-serif bold italic -typeshape that can be used for vector and tensor symbols. +The `isomath` package implements an `“ISO” math style`_, provides `new math +alphabets`_ with *bold italic* and *sans-serif bold italic* type and macros +for `semantic markup`_ of vector, matrix and tensor symbols. It can be +combined with most packages for mathematical typesetting (see +`<isomath-test.tex>`_ and the sections on alternatives_ and conflicts_). -.. _`equal treatment of Latin and Greek`: -ISO math style -~~~~~~~~~~~~~~ +“ISO” math style +~~~~~~~~~~~~~~~~ -The required package fixmath_ changes the default math layout to the -“ISO” `math style`_: +Isomath builds on the package fixmath_ by Walter Schmidt to change the +default mathematics layout to the “ISO” `math style`_: -+ Uppercase Greek letters are typeset italic by default. ++ Capital Greek letters are typeset in italic shape by default. + Both, Greek and Latin letters change shape if a different `math alphabet`_ is used. -However, fixmath works only for the Computer Modern font family. -With `isomath`, - -+ the used math fonts are configurable (using the rmdefault_ and - sfdefault_ options), and - -+ upright Greek letters can be made available through the common - ``\math*`` alphabets via the `OMLmath*`_ options if the - corresponding fonts support the `OML font encoding`_. - .. Caution:: - Using Greek letters in standard `math alphabets`_, e. g., - ``\mathrm{\pi}``, can lead to garbage, as the standard math - alphabets are usually taken from text fonts that have ligatures and - non-alpha symbols in place of the small Greek letters. - Do not use small Greek letters in the standard math alphabet commands - ``mathit``, ``mathrm``, ``mathbf``, ``mathsf``, and ``mathtt`` - unless you use the `OMLmath*`_ options. + Be careful with Greek letters in the argument of ``\mathit``, ``\mathrm``, + ``\mathbf``, ``\mathsf``, and ``\mathtt``. By default, these `math + alphabets`_ use text fonts. Fonts in OT1 text font encoding have capital + (but not small) Greek letters at the expected places, T1 encoded text fonts + have no Greek letters at all. - Some packages provide alternative macros or options for upright - Greek letters (cf. `Table 6`_). + See the examples_ section on `how to get upright small Greek letters`_ in + mathematical context. New math alphabets ~~~~~~~~~~~~~~~~~~ -`Isomath` defines three new `math alphabets`_: +`Isomath` defines the new `math alphabets`_: - .. class:: borderless +.. class:: borderless - =============== ====================== ================================= - ``\mathbfit`` boldface italic vector and matrix symbols - ``\mathsfit`` sans-serif italic optional (see OMLmath*_ options) - ``\mathsfbfit`` sans-serif bold italic tensor symbols - =============== ====================== ================================= +=============== ====================== ================================= +``\mathbfit`` boldface italic vector and matrix symbols +``\mathsfit`` sans-serif italic optional (see OMLmath*_ options) +``\mathsfbfit`` sans-serif bold italic tensor symbols +=============== ====================== ================================= + +For compatibility with earlier versions and `related packages`_, the +new math alphabets are also available under the aliases +``\mathbold``, ``\mathsans``, and ``\mathboldsans``. The rmdefault_ and sfdefault_ options_ set the font family used for these alphabets. .. Caution:: - Using the new math alphabets for numbers can result in _`upright - old-style numbers` instead of italic ones, because some italic math - fonts (e. g., cmr, cmbr) have old-style numbers in place of italic - digits. + Using the new math alphabets for numbers can result in upright old-style + numbers instead of italic ones, because some italic math fonts (e. g., + ``cmr``, ``cmbr``) contain old-style in place of italic digits. -For compatibility with earlier versions and `related packages`_, the -new math alphabets are also available under the aliases -``\mathbold``, ``\mathsans``, and ``\mathboldsans``. Semantic markup ~~~~~~~~~~~~~~~ -The following commands set the argument in an ISO-conforming math alphabet: +The following commands set the argument in an ISO-conforming `math alphabet`_: - .. class:: borderless +.. class:: borderless - ========================== ======================================== - ``\vectorsym, \matrixsym`` bold italic for Greek and Latin letters, - bold upright for numbers +========================== ======================================== +``\vectorsym, \matrixsym`` bold italic for Greek and Latin letters, + bold upright for numbers - ``\tensorsym`` sans-serif bold italic - ========================== ======================================== +``\tensorsym`` sans-serif bold italic +========================== ======================================== Usage ----- -Make sure that LaTeX can find ``isomath.sty`` and load it with -``\usepackage`` (see also Options_ and Examples_). +Make sure that LaTeX can find ``isomath.sty`` and load it with:: + + \usepackage{isomath} + +Optionally redefine the standard vector macro ``\vec``:: + + \renewcommand{\vec}{\vectorsym} + +(see also Options_, Examples_, and isomath-test.tex_). Options ~~~~~~~ @@ -153,7 +158,7 @@ family (the value of ``\rmdefault``). The font must be available in sfdefault ''''''''' -Family for sans-serif math fonts. The default is ``cmbr`` because many +Family for sans-serif math fonts. The default is ``cmbr`` because most sans-serif fonts define the Computer Roman font `cmm` as OML substitution (see `Table 4`_). @@ -161,26 +166,25 @@ There are only few sans serif fonts in `OML font encoding`_: .. class:: borderless -========== =========== =================================================== +========== =========== ===================================================== Name Package Comment -========== =========== =================================================== +========== =========== ===================================================== ``cmbr`` cmbright_ `Computer Modern Bright`, bitmap, slightly lighter than cmss (Type 1 fonts with hfbright_) -``fav`` arev_ `Arev` (`Vera Sans`) with math extension, - large x-height -``iwona`` iwona_ Humanistic Sans Serif, - some shapes very similar to roman +``fav`` arev_ `Arev` (`Vera Sans`), large x-height ``hvm`` hvmath_ `Helvetica Math`, commercial, free bitmap version -``llcmss`` lxfonts_ `LX Fonts`, very wide, eccentric, large x-height, - new in 2008 -========== =========== =================================================== +``iwona`` iwona_ `Iwona`, humanistic sans serif, + some shapes very similar to roman +``jkpss`` kpfonts_ `Kepler Sans`, quite light +``llcmss`` lxfonts_ `LX Fonts`, “slide fonts”, very wide, large x-height +========== =========== ===================================================== scaled '''''' -To improve the chances of configuring a matching sans serif math font, -the fonts, ``fav``, ``llcmss``, and ``iwona`` can be scaled with the -``scaled`` option (cf. Examples_). +To improve the chances of finding a matching sans serif math font, the +fonts ``fav``, ``iwona``, ``jkpss``, and ``llcmss`` can be scaled with the +``scaled`` option (cf. Examples_). For other fonts, the option is ignored. reuseMathAlphabets @@ -191,34 +195,35 @@ option tells `isomath` to re-use the existing ``\mathbf`` and ``\mathsf`` alphabets for italic bold and sans-serif bold. [#]_ .. [#] To access the upright shapes, the corresponding ``\textbf`` and - ``\textsf`` commands might be used. However, this toggles the - math-mode off and might use a different font, so watch for - side-effects. + ``\textsf`` commands might be used. Watch for side-effects, as these + commands switch to text mode so that the font settings in the embedding + text apply. .. _OMLmath*: OMLmathrm, OMLmathbf, OMLmathsf, OMLmathsfit, OMLmathtt ''''''''''''''''''''''''''''''''''''''''''''''''''''''' -With Greek letters defined as ``\mathalpha``, the letter fonts are -expected to be in `OML font encoding`_. The predefined -`math alphabets`_, however, use OT1 encoded text fonts. These fonts -have ligatures and accents in place of the small Greek letters. -The ``\mathsfit`` alphabet is not required for ISO conforming math. - The ``OMLmath*`` options bind the corresponding ``\math*`` command to an OML-encoded font. -This enables use of small Greek letters in `math alphabet`_ commands, -e. g., ``\mathrm{\pi}`` *if an OML encoded font is available*. -`Table 3`_ lists font families supporting the OML encoding. + +The ``\mathsfit`` alphabet is not required for ISO conforming mathematical +layout and therefore only defined if the ``OMLmathsfit`` argument is used. + +The predefined `math alphabets`_ ``\mathrm``, ``\mathbf``, and ``\mathtt`` +use OT1 encoded text fonts with ligatures and accents in place of the small +Greek letters. The ``OMLmath*`` options enable the use of small Greek +letters in `math alphabet`_ commands, e. g. ``\mathrm{\pi}``, if the +corresponding font is available in `OML font encoding`_. `Table 3`_ lists +font families supporting the OML encoding. .. caution:: - If no matching OML encoded font is found, LaTeX's substitute - mechanism kicks in and selects a font with different font attributes - (for all letters, not only Greek). Currently, only the mathdesign_ - package provides upright fonts in OML encoding. Many font packages - define an *italic* font as OML substitute for roman fonts. + If no matching OML encoded font is found, LaTeX's substitute mechanism + selects a font with different font attributes (for all letters, not only + Greek). Currently, only the mathdesign_ package provides upright fonts in + OML encoding. Many font packages define an *italic* font as OML substitute + for roman fonts. With some packages, these options can result in a “`too many math alphabets used in version normal`_” error. @@ -227,13 +232,7 @@ e. g., ``\mathrm{\pi}`` *if an OML encoded font is available*. Examples ~~~~~~~~ -* Redefine the standard ``\vec`` command to set its argument in an - ISO-conforming math alphabet.:: - - \usepackage{isomath} - \renewcommand{\vec}{\vectorsym} - -* Use scaled arev_ fonts for the sans serif alphabets +* Use scaled arev_ fonts for the sans serif math alphabets (adapt the scaling factor to your needs):: \usepackage[sfdefault=fav,scaled=0.875]{isomath} @@ -254,7 +253,8 @@ Examples \DeclareFontShape{OML}{fav}{bx}{it}{<-> s * [0.875] zavmbi7m}{} \SetMathAlphabet{\mathsfbfit}{bold}{OML}{fav}{bx}{it} -See also the ``isomath-test.tex`` test document. +See also the `isomath-test.tex`_ test document. + How to get upright small Greek letters '''''''''''''''''''''''''''''''''''''' @@ -278,16 +278,16 @@ b) To get upright small Greek letters without affecting other fonts, (check if the letter shapes match with the rest of the document). c) Use a package that provides macros for upright Greek letters - in math: - - .. class:: borderless - - ============= ===================================== - fourier_ ``\otheralpha ... \otherOmega`` - kpfonts_ ``\alphaup ... \Omegaup`` - mathdesign_ ``\alphaup ... \Omegaup`` - upgreek_ ``\upalpha ... \upOmega`` - ============= ===================================== + in math mode: + + .. class:: borderless + + ============= ===================================== + fourier_ ``\otheralpha ... \otherOmega`` + kpfonts_ ``\alphaup ... \Omegaup`` + mathdesign_ ``\alphaup ... \Omegaup`` + upgreek_ ``\upalpha ... \upOmega`` + ============= ===================================== d) Use an upright text character (requires a matching LGR-encoded Greek text font). The following lines redefine ``\pi`` to set @@ -299,6 +299,15 @@ d) Use an upright text character (requires a matching LGR-encoded \let\mathpi\pi \renewcommand{\pi}{\text{\textrm{\greektext p }}} +e) Use the text character with the `alphabeta` package from the lgrx_ + bundle:: + + \usepackage{amsmath} + \usepackage{alphabeta} + + and in the body :: + + $ u = 2 \text{\pi} r $ Related packages @@ -337,23 +346,26 @@ arev_ Alternatives ~~~~~~~~~~~~ -See `Table 2`_ for other packages that implement the “ISO” `math -style`_ and `Table 6`_ for packages that provide bold italic -math fonts. +The TUGboat article by Claudio Beccari [becc97]_ discusses tricks and +commands for physicists and engineers in order to satisfy the international +regulations and to distinguish similar symbols with different meanings. + +See `Table 2`_ for other packages that implement the “ISO” `math style`_ and +`Table 6`_ for packages that provide bold italic math fonts. `“In-line math versions”`_ can be used as ISO-conforming replacement for ``\vec``: + * ``\bm`` from the `bm`_ package. Combining `bm` and `isomath` may + lead to the `too many math alphabets used in version normal`_ error. + * ``\boldsymbol`` from `amsbsy`_ (part of `amsmath`_, the near-indispensable adjunct to serious mathematical typesetting in LaTeX), - * ``\bm`` from the `bm`_ package. Combining `bm` and `isomath` may - lead to the `too many math alphabets used in version normal`_ error. - -``\text`` - from `amsmath`_ can be used to get, e. g., upright or sans-serif - bold italic Greek symbols from a text font into a formula (see +amsmath_ + provides the command ``\text``, that can be used to get, e. g., upright or + sans-serif bold italic Greek symbols from a text font into a formula (see `How to get upright small Greek letters`_). unicode-math_ @@ -361,7 +373,7 @@ unicode-math_ math fonts. It supports the “ISO” `math style`_ and all mathematical characters in the Unicode standard. - unicode-math cannot be used together with `isomath`. It can, however, + `unicode-math` cannot be used together with `isomath`. It can, however, replace all of isomath's functionality. See the discussion of `the unicode-math package`_ below. @@ -379,10 +391,11 @@ Conflicts Examples for problematic combinations: + The `kpfonts`_, `pxfonts`_, and `txfonts`_ packages define many - additional math alphabets. + additional math alphabets (`kpfonts` works with `isomath`, if + it is loaded with ``\usepackage[nomathscript]{kpfonts}``). + The `bm`_ package normally allocates several symbol fonts for bold - and heavy fonts. Their number can be customized by defining + and heavy fonts. Their number can be customised by defining ``\bmmax`` and ``\hmmax`` before loading the package. fourier_ @@ -397,13 +410,19 @@ fourier_ \usepackage[OMLmathbf,rmdefault=mdput, sfdefault=arev,scaled=0.85]{isomath} +sansmath_ + defines a ``sans`` `math version`_ using **text** fonts in OT1 or T1 font + encoding. As fixmath/isomath expect math fonts in `OML font encoding`_, + Greek letters will not work inside the ``sans`` math version defined by + sansmath. + Background ---------- -This section discusses LaTeX `math font selection`_, suitable -`math letter fonts`_ for the ISO math style, and the relation of LaTeX and -`Unicode mathematical typesetting`_. +This section discusses LaTeX `math font selection`_, the `OML font +encoding`_, and the relation of LaTeX and `Unicode mathematical +typesetting`_. Math font selection @@ -412,14 +431,14 @@ Math font selection There are three complementary methods to set font attributes in LaTeX math mode: `LaTeX 2e font selection` [fntguide]_ describes `math alphabets`_ and `math versions`_, several extension packages -provide alternative `math styles`_ (cf. `Table 2`_). +provide alternative `math styles`_. .. _math alphabet: Math alphabets '''''''''''''' -Math alphabets are a counterpart to the `mathematical alphanumeric +TeX's *math alphabets* correspond to the `mathematical alphanumeric symbols`_ block in Unicode. Both are “to be used for mathematical variables where style variations are important semantically”. The font guide [fntguide]_ defines in @@ -437,17 +456,17 @@ section 3: The _`predefined math alphabets` are: - .. class:: borderless + .. class:: borderless - ================= =============== - ``\mathnormal`` default [#mathnormal]_ - ``\mathrm`` roman [#roman]_ - ``\mathbf`` bold roman - ``\mathsf`` sans serif - ``\mathit`` text italic - ``\mathtt`` typewriter - ``\mathcal`` calligraphic - ================= =============== + ================= =============== + ``\mathnormal`` default [#mathnormal]_ + ``\mathrm`` roman [#roman]_ + ``\mathbf`` bold roman + ``\mathsf`` sans serif + ``\mathit`` text italic + ``\mathtt`` typewriter + ``\mathcal`` calligraphic + ================= =============== .. [#mathnormal] ``\mathnormal`` is used by default for alphanumeric characters in math mode. It sets the letter shape according to @@ -470,53 +489,61 @@ letter ``a`` in **upright** bold type. Math versions ''''''''''''' -The number of mathematical symbols exceeds the maximal number of -characters in a TeX font file by an order of magnitude. [#max]_ -Grouping math fonts with common characteristics in math versions -simplifies the setting of font attributes for mathematical expressions. +*Math versions* specify the mapping from commands for mathematical +symbols and `math alphabets`_ to a set of mathematical fonts [#]_. +They are intended for mathematical content in a special context like a +bold section heading. Selecting a math version resembles +the individual selection of text font attributes. + +Example: + Some alternatives to set the letter ``a`` in a bold upright sans-serif + font: + + .. class:: borderless + + ============================ =================================== + Text Math + ============================ =================================== + ``\textbf{\textsf{a}}`` ``$\bm{\mathsf{a}}$`` + ``\bfseries \textsf{a}`` ``\mathversion{bold} $\mathsf{a}$`` + ``\bfseries \sffamily a`` ``$\mathsfbf{a}$`` + ============================ =================================== -*Math versions* set up “math symbol fonts” for non-alphanumeric -symbols and bind the `math alphabet`_ commands to fonts using default -values for non-specified font attributes. TeX limits the number of -(symbol + alphanumeric) fonts per math version to 16. The predefined math versions are ``normal`` and ``bold`` with the -defaults: +following defaults for non-specified font attributes: - .. class:: borderless +.. class:: borderless - ======== ========== ======== - .. ``normal`` ``bold`` - *type* serif serif - *weight* medium bold - *shape* upright upright - ======== ========== ======== +========= ========== ======== +attribute ``normal`` ``bold`` +========= ========== ======== +*type* serif serif +*weight* medium bold +*shape* upright upright +========= ========== ======== -Packages can define additional math versions, e. g., the wrisym_ package -defines a ``mono`` math version. A ``sans`` math version example is -available from a `comp.text.tex post -<http://newsgroups.derkeiler.com/Archive/Comp/comp.text.tex/2007-09/msg00181.html>`__ +Packages can define additional math versions, e. g., the kpfonts_ package +defines a ``sans`` math version (another ``sans`` math version example is +available from a `comp.text.tex post``__) and the wrisym_ package defines a +``mono`` math version. -Math versions are intended for mathematical content in a special -context, e. g., a bold section heading. -Setting a math version resembles the individual selection of text -font attributes (bold, sans-serif, monospaced). +__ http://newsgroups.derkeiler.com/Archive/Comp/comp.text.tex/2007-09/msg00181.html Math versions can only be changed outside of math mode. The commands ``\boldsymbol`` (amsmath_) and ``\bm`` (bm_) behave like _`“in-line math versions”`: they typeset their argument using the fonts of the ``bold`` math version but can be used inside math mode. -Example: four ways to set the letter ``a`` in a bold -sans-serif font:: - - % Text Math: - \textbf{\textsf{a}} $\bm{\mathsf{a}}$ - \bfseries \textsf{a} \mathversion{bold} $\mathsf{a}$ +.. [#] The number of mathematical symbols exceeds the maximal number of + characters in a TeX font file by an order of magnitude: Unicode + defines about 2500 mathematical characters [tr25]_, font files used by + 8-bit TeX engines are limited to 256 characters. The standard math + fonts adhere to the original limit of 128 characters. Grouping math + fonts with common characteristics in math versions simplifies the + setting of font attributes for mathematical expressions. TeX limits + the number of (symbol + alphanumeric) fonts per math version to 16. -.. [#max] Unicode provides about 2500 math characters. Font files used - by 8-bit TeX engines can hold up to 256 characters. The standard - math fonts adhere to the original limit of 128 characters. .. _math style: @@ -525,9 +552,16 @@ Math styles A *math style* is a document-level feature that determines the default letter shape in math mode (i. e. the shape attribute of letters in the -``\mathnormal`` `math alphabet`_). +``\mathnormal`` `math alphabet`_). [#]_ +LaTeX defaults to the “TeX” math style (without naming it such). +Alternative math styles are introduced by extension packages +(`Table 2`_). + +.. [#] The ``math-style`` option of unicode-math_ changes also the shape + attribute of other math alphabets (see also section + `the unicode-math package`_). -.. _Table 1: +.. _ Table 1: .. table:: Default letter shapes for common math styles @@ -540,13 +574,10 @@ letter shape in math mode (i. e. the shape attribute of letters in the upright up up up up ============ ======= ======= ======= ======= -LaTeX defaults to the “TeX” math style (without naming it such). -Alternative math styles are introduced by extension packages -(`Table 2`_). .. _Table 2: -.. table:: Packages providing math styles +.. table:: Packages providing alternative math styles ============ ============= ================================== math style Package Option(s) @@ -572,11 +603,11 @@ Alternative math styles are introduced by extension packages ============ ============= ================================== -Math letter fonts +OML font encoding ~~~~~~~~~~~~~~~~~ -The equal treatment of Latin and Greek letters in the `ISO math -style`_ is simplest achieved with a font that contains all required +The equal treatment of Latin and Greek letters in the `“ISO” math +style`_ is best achieved with a font that contains all required letters in one file. There is only one established LaTeX font encoding that contains Latin and @@ -585,22 +616,22 @@ encoding `T7` is just a “reserved name” and the de-facto standard Greek text font encoding `LGR` has no Latin letters. Unfortunately, `OML support`_ is limited to a few (mostly italic) fonts. -OML font encoding -''''''''''''''''' +Discussion +'''''''''' The `LaTeX font encodings` guide [encguide]_ names the OML encoding `TeX math italic` and defines: - The _`OML` encoding contains italic Latin and Greek letters for use in - mathematical formulas (typically used for variables) together with some + The OML encoding contains italic Latin and Greek letters for use in + mathematical formulae (typically used for variables) together with some symbols. The reference to *italic* shape is odd: -* No other font encoding is specific to the font shape. +* No other font encoding is specific to a font shape. * The different font selection and the semantic of font features in - math do not interfere with the font *encoding*: Both, + mathematical formulae do not interfere with the font *encoding*: Both, ``\DeclareSymbolFont`` and ``\DeclareMathAlphabet`` require a shape argument. Thus it is possible to set up OML encoded math alphabets in roman {n} as well as italic {it} shape without @@ -615,7 +646,7 @@ Proposals: * Drop the *italic* from the definition. Optionally add an explanation: The OML encoding contains Latin and Greek letters for use in - mathematical formulas (typically used for variables) together with + mathematical formulae (typically used for variables) together with some symbols. It first appeared in the `Computer Modern Math Italic` (cmmi) font. @@ -635,7 +666,7 @@ families even if the text font defines Greek letters. Supported font families can be found searching for ``oml*.fd`` files and grepping for ``DeclareFont.*OML`` in ``*.sty`` files. -`Table 3`_ lists the findings for a selection of TeXLive 2009 + some +`Table 3`_ lists the findings for a selection of TeXLive 2012 + some additionally installed font packages. * If there is an alias (substitution) from the text font to a @@ -645,56 +676,69 @@ additionally installed font packages. however mapping to an italic variant of the OML encoded font. These are not listed as supporting ``m/n`` or ``bx/n`` here. +`Table 4`_ lists some fonts that define ``cmm`` as OML substitution. +With `isomath`, a better matching substitution can be set using the +rmdefault_ or sfdefault_ options. + .. _Table 3: .. table:: Font families supporting the OML encoding - ============= =========================== ======= ======== ====== ======= - Name Family m/it bx/it m/n bx/n - ============= =========================== ======= ======== ====== ======= - aer AE (Almost European) ✓ ✓ - antt Antykwa Torunska ✓ ✓ - cmr Computer Modern Roman ✓ ✓ - ccr Concrete ✓ ✓ - cmbr Computer Modern Bright ✓ ✓ - hlh Lucida ✓ ✓ - hfor CM with old-style digits ✓ ✓ - iwona Iwona (sans serif) ✓ ✓ - jkp Kepler Serif ✓ ✓ - jkpl Kepler Serif ✓ ✓ - jkpvos Kepler Serif ✓ ✓ - jkplvos Kepler Serif ✓ ✓ - llcmm LX Fonts (sans serif) ✓ ✓ - lmr Latin Modern Roman ✓ ✓ - mak Kerkis ✓ - kurier Kurier ✓ ✓ - mdbch Math Design Charter ✓ ✓ ✓ ✓ - mdput Math Design Utopia ✓ ✓ ✓ ✓ - mdugm Math Design Garamond ✓ ✓ ✓ ✓ - neohellenic GFS Neohellenic ✓ - plcm CM (PLaTeX) ✓ - ptmom Times (Omega or MB-Times) ✓ ✓ - ptmomu Times (Omega or MB-Times) ✓ ✓ - ptmcm Times (psfont) ✓ - pxr Palatino (pxfonts) ✓ ✓ - qpl Palatino/Pagella (qpxmath) ✓ ✓ - qtm Times/Termes (qtxmath) ✓ ✓ - txr Times (txfonts) ✓ ✓ - udidot Didot (gfsdidot) ✓ - ywclm (greektex) ✓ ✓ - zavm Arev (Vera Sans-Serif) ✓ ✓ - zesfcm (efont) ✓ - zplm Palatino (mathpazo) ✓ ✓ - zpple Palatino ✓ ✓ - ztmcm Times (mathptmv) ✓ - zer Computer Modern (zefonts) ✓ ✓ - ============= =========================== ======= ======== ====== ======= + ============= ================================= ======= ======== ====== ======= + Name Family (package) m/it bx/it m/n bx/n + ============= ================================= ======= ======== ====== ======= + antt Antykwa Torunska (anttor_) ✓ ✓ + cmr Computer Modern ✓ ✓ + ccr Concrete Roman (concmath_) ✓ ✓ + cmbr CM Bright (cmbright_) ✓ ✓ + hlh Lucida ✓ ✓ + hfor CM with old-style digits ✓ ✓ + iwona Iwona (sans serif) (iwona_) ✓ ✓ + iwonal Iwona light ✓ ✓ + iwonac Iwona condensed ✓ ✓ + iwonalc Iwona light condensed ✓ ✓ + jkp Kepler Serif (kpfonts_) ✓ ✓ + jkpw Kepler Serif wide ✓ ✓ + jkpvos Kepler Serif oldstyle ✓ ✓ + jkpvosw Kepler Serif oldstyle wide ✓ ✓ + jkpl Kepler Serif light ✓ ✓ + jkplw Kepler Serif light wide ✓ ✓ + jkplvos Kepler Serif light oldstyle ✓ ✓ + jkplvosw Kepler Serif light os wide ✓ ✓ + jkpss Kepler Sans (kpfonts_) ✓ ✓ + jkpssvos Kepler Sans oldstyle ✓ ✓ + jtm expanded Times (jamtimes_) ✓ ✓ + llcmm LX Fonts (sans serif) (lxfonts_) ✓ ✓ + lmr Latin Modern Roman (lmodern) ✓ ✓ + mak Kerkis (kerkis_) ✓ + kurier Kurier (sans serif) (kurier_) ✓ ✓ + kurierc Kurier condensed ✓ ✓ + kurierl Kurier light ✓ ✓ + kurierlc Kurier light condensed ✓ ✓ + mdbch Math Design Charter (mathdesign_) ✓ ✓ ✓ ✓ + mdput Math Design Utopia ✓ ✓ ✓ ✓ + mdugm Math Design Garamond ✓ ✓ ✓ ✓ + neohellenic Neohellenic (gfsneohellenic_) ✓ + ntxmi Times (newtx_) ✓ ✓ + nxlmi Libertine (newtx_) ✓ ✓ + plcm CM (PLaTeX) ✓ + ptmom Times (Omega or MB-Times) ✓ ✓ + ptmomu Times (Omega or MB-Times) ✓ ✓ + ptmcm Times (mathptmx_) ✓ + pxr Palatino (pxfonts_) ✓ ✓ + qpl Palatino/Pagella (qpxmath) ✓ ✓ + qtm Times/Termes (qtxmath) ✓ ✓ + txr Times (txfonts_) ✓ ✓ + udidot Didot (gfsdidot_) ✓ + ywclm (greektex_) ✓ ✓ + zavm Arev (Vera Sans-Serif) ✓ ✓ + zplm Palatino (mathpazo_) ✓ ✓ + zpple Palatino ✓ ✓ + ztmcm Times (mathptmx_) ✓ + zer Computer Modern (zefonts_) ✓ ✓ + ============= ================================= ======= ======== ====== ======= -`Table 4`_ lists some fonts that define ``cmm`` as OML substitution. -With `isomath`, a better matching substitution can be set using the -rmdefault_ or sfdefault_ options. - .. _Table 4: .. table:: Non-CM fonts with ``cmm`` as OML substitution @@ -716,7 +760,7 @@ rmdefault_ or sfdefault_ options. ubk Bookman (bookman) ucr Courier (courier) ucrs Courier - unc New Courier (nctrsbk) + unc New Century Schoolbook (psnfss) uni Universal (universa) uhv Helvetica (helvetic) upl Palatino (palatino) @@ -728,35 +772,61 @@ rmdefault_ or sfdefault_ options. Unicode mathematical typesetting ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +This section compares `math font selection`_ in LaTeX and Unicode. It +suggests a set of 14 math alphabet commands that covers all Unicode +`mathematical alphanumeric symbols`_ and discusses compatibility issues +between math typesetting with traditional (8-bit) TeX engines versus `the +unicode-math package`_ for Unicode-enabled TeX engines (XeTeX, LuaTeX). + The technical report [tr25]_ presents an in-depth discussion of the -mathematics character repertoire of the Unicode Standard as well as +mathematical character repertoire of the Unicode Standard as well as mathematical notation in general. -This section compares `math font selection`_ in LaTeX and Unicode. -It suggests a set of 14 math alphabets that covers all Unicode -`mathematical alphanumeric symbols`_ and discusses compatibility -issues between math typesetting with traditional (8-bit) TeX engines -versus `the unicode-math package`_ for Unicode-enabled TeX engines -(XeTeX, LuaTeX). - .. _mathematical alphanumeric symbols: -Unicode math alphabets -'''''''''''''''''''''' +Unicode mathematical alphabets +'''''''''''''''''''''''''''''' Chapter 2 `Mathematical Character Repertoire` of [tr25]_ lists 14 `Mathematical Alphabets` in Table 2.1. These mathematical alphabets are a superset of the predefined `math alphabets`_ in the LaTeX core. -Unicode assignes code points to most letters of the mathematical +Unicode assigns code points to most letters of the mathematical alphabets in the `mathematical alphanumeric symbols Unicode block`_. -The plain (upright, serifed) letters have been unified with the +The plain (upright) letters have been unified with the existing characters in the Basic Latin and Greek blocks. `Table 5`_ maps the 14 Unicode mathematical alphabets to LaTeX commands according to the `naming scheme`_ below. `Table 6`_ lists the status of -LaTeX support for the mathematical alphanumeric symbols. Full support is -provided by `the unicode-math package`_. +LaTeX support for the mathematical alphanumeric symbols. + +Naming scheme +````````````` + +The naming scheme is an extension of the predefined `math alphabet`_ +commands with the established short-cuts: + +.. class:: borderless + +===== ================================ +bf bold +it italic +cal script (calligraphic) +frak fraktur +bb double-struck (blackboard bold) +sf sans serif +===== ================================ + +combined to commands in the form ``\math<type><weight><shape>``. + +The <*type*>, <*weight*>, and <*shape*> specifiers are optional +(defaults depend on the `math version`_). Their order matches the +names of Unicode `Mathematical Alphanumeric Symbols`_. + +Examples:: + + \mathbf{d} % MATHEMATICAL BOLD SMALL D + \mathsfbfit{d} % MATHEMATICAL SANS-SERIF BOLD ITALIC SMALL D. .. _table 5: @@ -786,33 +856,12 @@ provided by `the unicode-math package`_. .. [#up] plain standard characters outside the `mathematical alphanumeric symbols` Unicode block. -Naming scheme +LaTeX support ````````````` -The naming scheme is an extension of the predefined `math alphabet`_ -commands with the established short-cuts: - - .. class:: borderless - - ===== ================================ - bf bold - it italic - cal script (calligraphic) - frak fraktur - bb double-struck (blackboard bold) - sf sans serif - ===== ================================ - -combined to commands in the form ``\math<type><weight><shape>``. - -The <*type*>, <*weight*>, and <*shape*> specifiers are optional -(defaults depend on the `math version`_). Their order matches the -names of Unicode `Mathematical Alphanumeric Symbols`_. - -Examples:: - - \mathbf{d} % MATHEMATICAL BOLD SMALL D - \mathsfbfit{d} % MATHEMATICAL SANS-SERIF BOLD ITALIC SMALL D. +Most commonly used math alphabets are supported either by the TeX kernel +or additional packages. Full support is only provided by `the unicode-math +package`_. .. _Table 6: @@ -823,7 +872,7 @@ Examples:: style math alphabet package, comment ============ ========================= =========================== plain [#up]_ ``\mathrm`` predefined [#no-g]_ - .. ``\mathup`` unicode-math_ + .. ``\mathup`` unicode-math_, kpfonts_ bf ``\mathbf`` predefined [#no-g]_ it ``\mathit`` predefined [#no-g]_ bf it ``\mathbfit`` isomath [#digits]_ @@ -840,7 +889,7 @@ Examples:: bf frak ``\mathbffrak`` unicode-math_ bb ``\mathbb`` amssymb_, bbold_, mathbbol_, mbboard_, - mathpazo_ + mathpazo_, sbbm_ .. ``\mathbbm`` bbm_ .. ``\mathds`` dsfont (doublestoke_) sf ``\mathsf`` predefined [#no-g]_ @@ -852,10 +901,12 @@ Examples:: tt ``\mathtt`` predefined [#no-g]_ ============ ========================= =========================== -.. [#no-g] no small Greek, full Greek with `OMLmath*`_ options. +.. [#no-g] no small Greek, full Greek with `OMLmath*`_ options and + OML-encoded fonts .. [#digits] Some italic math fonts (e. g., cmr, cmbr) have old-style numbers in place of italic digits. -.. [#script] no small Latin, formal script with calrsfs_, eucal_, fourier_ +.. [#script] formal script with calrsfs_, eucal_, fourier_, + small Latin letters only with urwchancal_ The unicode-math package @@ -865,18 +916,19 @@ Users of UTF-8 enabled TeX engines (XeTeX, LuaTeX) can typeset mathematics with the experimental unicode-math_ package by Will Robertson. It provides a LaTeX interface to OpenType fonts with math support, e. g., `Asana Math`_, Cambria Math, `New Euler`_ or XITS_, with -commands to access the complete mathematics character repertoire of the -Unicode Standard +commands to access the complete mathematical character repertoire of the +Unicode Standard. LaTeX `math font selection`_ methods with unicode-math: -`math alphabets`_ - map to a range of the `mathematical alphanumeric symbols`_ block in the - current font (or a substitution defined with the ``range`` math font - option). +* `Math alphabets`_ map to a range of the `mathematical alphanumeric + symbols`_ block in the current font (or a substitution defined with the + ``range`` math font option). Some command names differ from the `predefined math alphabets`_ or the above `naming scheme`_: + + .. class:: borderless =============== =============== LaTeX unicode-math @@ -894,46 +946,21 @@ LaTeX `math font selection`_ methods with unicode-math: ``sans-style=upright``. ``\mathbfsfit`` reverses the order of the ``sf`` and ``bf`` selectors, - so that, e. g., the Unicode character `MATHEMATICAL SANS-SERIF BOLD - ITALIC CAPITAL A` is selected by the non-mnemonic ``\mathbfsfit{A}``. - -`math versions`_ - are not directly supported but easy to emulate. - - As Unicode fonts can hold all math symbols in a single font file, a - single ``\setmathfont[<font features>]{<font name>}`` can replace - the ``\mathversion{<mathversion>}`` command if a complete OpenType - math font in the desired version is available. - + so that, e. g., the Unicode character MATHEMATICAL SANS-SERIF BOLD + ITALIC CAPITAL A is selected by the non-mnemonic ``\mathbfsfit{A}``. - However, complete OpenType math fonts are rare. Therefore - unicode-math supports using multiple fonts with the ``range`` - option. This way one can emulate, e. g., the ``bold`` math version - via:: +* `Math versions`_ can be set up using the syntax + ``\setmathfont[version=<version name>,<font features>]{<font name>}`` - \renewcommand{\boldmath}{% - \setmathfont{XITS Bold}% - \setmathfont[range={"1D400-"1F020}]{XITS Math}% - \setmathfont[range=\mathup->\mathbfup]{XITS Math}% - \setmathfont[range=\mathsfit->\mathbfsfit]{XITS Math}% - % ... - } - - It would be nice if unicode-math could provide a ``\newmathversion`` - command similar to the ``\newfontfamily`` in fontspec_ for such setups. - - For alphanumerical characters, the ``\mathbf``, ``\mathsf``, and - ``\mathsfbf`` behave like `“in-line math versions”`_. - -`math styles`_ - are supported with the ``math-style`` package option that accepts the - values ``TeX``, ``ISO``, ``french``, ``upright``, and ``literal``. +* Several `math styles`_ are supported with the ``math-style`` package + option that accepts the values ``TeX``, ``ISO``, ``french``, ``upright``, + and ``literal``. Conclusions and outlook ~~~~~~~~~~~~~~~~~~~~~~~ -It is hoped, that in the future more fonts families will support the +It is hoped, that in the future more font families will support the OML encoding in normal and bold weight as well as upright and italic shape. This would be a major step towards a LaTeX equivalent of the `mathematical alphanumeric symbols`_ Unicode block. @@ -942,9 +969,6 @@ This should be (relatively) easy to achieve via virtual fonts when the glyphs for the Greek letters already exist. Examples are Latin Modern, Kerkis, GFS Neohellenic, LX Fonts and KP-Serif. -Alternatively, the T7 encoding could be used for math alphabets (if it -ever happens to materialise). - Upright small Greek letters in ``\mathrm`` would enable the specification of the constant pi, Myons, Pions, alpha-particles, photons, and neutrinos with `math alphabets`_. (With mathdesign_ @@ -991,6 +1015,10 @@ References `Symbols, Units, Nomenclature and Fundamental Constants in Physics`: http://metrology.wordpress.com/measurement-process-index/iupap-red-book/index-iupap-red-book/. +.. [becc97] Claudio Beccari, `Typesetting mathematics for science and + technology according to ISO 31 XI`, TUGboat, Volume 18, 1997, No. 1: + http://www.tug.org/TUGboat/tb18-1/tb54becc.pdf. + .. [encguide] Frank Mittelbach, Robin Fairbairns, Werner Lemberg, LaTeX3 Project Team, `LaTeX font encodings`: http://mirror.ctan.org/macros/latex/doc/encguide.pdf. @@ -1026,6 +1054,7 @@ References .. _amsfonts: http://mirror.ctan.org/help/Catalogue/entries/amsfonts.html .. _amsmath: http://mirror.ctan.org/help/Catalogue/entries/amsmath.html .. _amssymb: http://mirror.ctan.org/help/Catalogue/entries/amssymb.html +.. _anttor: http://mirror.ctan.org/help/Catalogue/entries/anttor.html .. _arev: http://mirror.ctan.org/help/Catalogue/entries/arev.html .. _Asana Math: http://mirror.ctan.org/help/Catalogue/entries/asana-math.html .. _bm: http://mirror.ctan.org/help/Catalogue/entries/bm.html @@ -1033,7 +1062,9 @@ References .. _bbold: http://mirror.ctan.org/help/Catalogue/entries/bbold.html .. _calrsfs: http://mirror.ctan.org/help/Catalogue/entries/calrsfs.html .. _cmbright: http://mirror.ctan.org/help/Catalogue/entries/cmbright.html +.. _concmath: http://mirror.ctan.org/help/Catalogue/entries/concmath.html .. _doublestoke: http://mirror.ctan.org/help/Catalogue/entries/doublestoke.html +.. _efont: http://mirror.ctan.org/help/Catalogue/entries/efont.html .. _eucal: http://mirror.ctan.org/help/Catalogue/entries/eucal.html .. _eufrak: http://mirror.ctan.org/help/Catalogue/entries/eufrak.html .. _eulervm: http://mirror.ctan.org/help/Catalogue/entries/eulervm.html @@ -1042,13 +1073,20 @@ References .. _fix-cm: http://mirror.ctan.org/help/Catalogue/entries/fix-cm.html .. _fourier: http://mirror.ctan.org/help/Catalogue/entries/fourier.html .. _fontspec: http://mirror.ctan.org/help/Catalogue/entries/fontspec.html +.. _gfsdidot: http://mirror.ctan.org/help/Catalogue/entries/gfsdidot.html +.. _gfsneohellenic: http://mirror.ctan.org/help/Catalogue/entries/gfsneohellenic.html +.. _greektex: http://mirror.ctan.org/help/Catalogue/entries/greektex.html .. _hvmath: http://mirror.ctan.org/help/Catalogue/entries/hvmath.html .. _hfbright: http://mirror.ctan.org/help/Catalogue/entries/hfbright.html .. _ifthen: http://mirror.ctan.org/help/Catalogue/entries/ifthen.html .. _iwona: http://mirror.ctan.org/help/Catalogue/entries/iwona.html +.. _jamtimes: http://mirror.ctan.org/help/Catalogue/entries/jamtimes.html +.. _kerkis: http://mirror.ctan.org/help/Catalogue/entries/kerkis.html +.. _keyval: http://mirror.ctan.org/help/Catalogue/entries/keyval.html .. _kpfonts: http://mirror.ctan.org/help/Catalogue/entries/kpfonts.html +.. _kurier: http://mirror.ctan.org/help/Catalogue/entries/kurier.html .. _kvoptions: http://mirror.ctan.org/help/Catalogue/entries/kvoptions.html -.. _keyval: http://mirror.ctan.org/help/Catalogue/entries/keyval.html +.. _lgrx: http://mirror.ctan.org/help/Catalogue/entries/lgrx.html .. _lxfonts: http://mirror.ctan.org/help/Catalogue/entries/lxfonts.html .. _lucimatx: http://pctex.com/files/managed/b/bf/lucimatxAbbrev.pdf .. _mathbbol: http://mirror.ctan.org/help/Catalogue/entries/mathbbol.html @@ -1056,14 +1094,20 @@ References .. _mathdesign: http://mirror.ctan.org/help/Catalogue/entries/mathdesign.html .. _mathpazo: http://mirror.ctan.org/help/Catalogue/entries/mathpazo.html .. _mathptmx: http://mirror.ctan.org/help/Catalogue/entries/mathptmx.html +.. _mathptmv: http://mirror.ctan.org/help/Catalogue/entries/mathptmv.html .. _mathrsfs: http://mirror.ctan.org/help/Catalogue/entries/mathrsfs.html +.. _newtx: http://mirror.ctan.org/help/Catalogue/entries/newtx.html .. _New Euler: https://github.com/khaledhosny/euler-otf .. _pxfonts: http://mirror.ctan.org/help/Catalogue/entries/pxfonts.html +.. _sansmath: http://mirror.ctan.org/help/Catalogue/entries/sansmath.html +.. _sbbm: http://mirror.ctan.org/help/Catalogue/entries/sbbm.html .. _sfmath: http://dtrx.de/od/tex/sfmath.html .. _tmmath: http://mirror.ctan.org/help/Catalogue/entries/tmmath.html .. _txfonts: http://mirror.ctan.org/help/Catalogue/entries/txfonts.html .. _unicode-math: http://mirror.ctan.org/help/Catalogue/entries/unicode-math.html .. _upgreek: http://mirror.ctan.org/help/Catalogue/entries/upgreek.html +.. _urwchancal: http://mirror.ctan.org/help/Catalogue/entries/urwchancal.html .. _wrisym: http://phong.informatik.uni-leipzig.de/~kuska/wri_texmf_4.2.zip .. _XITS: http://mirror.ctan.org/help/Catalogue/entries/xits.html +.. _zefonts: http://mirror.ctan.org/help/Catalogue/entries/zefonts.html |