summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/fonts/libertinust1math/LibertinusT1Math-doc.tex
blob: e389260837cfe93efcf2ada46218aa8ecc485d2d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
% !TEX TS-program = pdflatexmk
\documentclass{article}
\usepackage[margin=1in]{geometry} 
\usepackage[parfill]{parskip}% Begin paragraphs with an empty line rather than an indent
\pdfmapfile{+libertinust1math.map}
\usepackage{graphicx}
%\usepackage{amssymb}% don't use with newtxmath
%SetFonts
% libertine+newtxmath
\usepackage[sb]{libertine} % use sb in place of bold
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage[varqu,varl]{zi4}% inconsolata
\usepackage{amsthm}
\usepackage{libertinust1math}
\usepackage{bm}
\useosf % use oldstyle figures except in math
\usepackage[cal=stix,scr=boondoxo]{mathalfa}% less slanted than STIX cal
\usepackage{booktabs}
\usepackage{fonttable}
\usepackage[supstfm=libertinesups,%
  supscaled=1.2,%
  raised=-.13em]{superiors}
%SetFonts
\title{The LibertinusT1 Math Package}
\author{Michael Sharpe}
\date{\today}  % Activate to display a given date or no date

\begin{document}
\maketitle
This package is a \LaTeX\ math package to accompany the \LaTeX\ Libertine text package, serving as an alternative to {\tt newtxmath} with the {\tt libertine} option. Both packages use the Greek and Roman letters from Libertine, but LibertinusT1Math symbols are mostly taken from the LibertinusMath font which extends and corrects  Libertine, while {\tt newtxmath} uses symbols matching Times in weight and size, and so are a bit heavier and larger. I've changed a number of glyphs from LibertinusMath and added dozens of new glyphs. Like LibertinusMath, LibertinusT1Math does not contain calligraphic, script or gothic alphabets. The package sets \verb|\mathcal| to the (unscaled) STIX calligraphic font and \verb|\mathbb| to the LibertinusT1Math double-struck alphabet.  The {\tt mathalfa} package (loaded AFTER {\tt libertinust1math}) offers a convenient way to change these default choices and to set the script and gothic alphabets. See the sample invocation below, which assumes you have {\tt mathalfa} version 1.08 (March 2016) or higher. 

\textsc{Package Options:}
\begin{itemize}
\item
{\tt lcgreekalpha} makes lower-case Greek letters be of type {\tt mathalpha} rather than {\tt mathord}, forcing them to respond to alphabet changing commands such as \verb|\mathnormal|, \verb|\mathrm|, \verb|\mathit| and \verb|\mathst|.
\item
{\tt upint} changes the style of integrals from the default \emph{slanted} to \emph{upright}.
\item {\tt frenchmath} changes the math style to use upright Greek and Roman capital letters rather than math italic shapes.
\item
{\tt slantedGreek} makes uppercase Greek math letters slanted. 
\item {\tt uprightGreek} makes uppercase Greek math letters upright. This is the default.
\end{itemize}
There is no {\tt scaled} option, as the scale is normally set to match that in {\tt libertine} by means of a macro in that package: \verb|\LinuxLibertineT@scale|. If you use {\tt libertinust1math} with a font package other than {\tt  libertine}, you can adjust the scale of {\tt libertinust1math} with, e.g.,
\begin{verbatim}
\makeatletter
\newcommand*{\LinuxLibertineT@scale}{1.03}
\makeatother
\end{verbatim}

\textsc{Sample Invocation:}
\begin{verbatim}
\usepackage[sb]{libertine}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage[varqu,varl]{zi4}% inconsolata for mono, not LibertineMono
\usepackage{amsthm} % libertinust1math loads amsmath
\usepackage{libertinust1math} % slanted integrals, by default
\usepackage[cal=stix,scr=boondoxo,bb=boondox]{mathalfa}
%If you want to use LibertinusT1 bb, omit bb=boondox
\end{verbatim}

\textsc{Some Things to Note:}
\begin{itemize}
\item The {\tt amsmath} package is loaded, if necessary, by {\tt libertinust1math}. The package depends on a number of its features and improvements to math typesetting.
\item
There are no bold symbols in LibertinusMath, but there are bold Roman and Greek letters, and the same is true of LibertinusT1Math.
\item The italic letter v (\emph{v}) in LibertinusMath is easily confused with Greek \verb|\nu| ($\nu$), so the math italic letter v is set to $v$, and similarly in the bold math version.
\item The layout of the type1 math fonts follows STIX to some extent, as does the sty file, though the content of this package is much less rich.
\item Dotlessi and dotlessj are available in four math styles---mathit, mathrm, mathbf and mathbfit. For example:
\begin{center}
  \begin{tabular}{@{} cc @{}}
    \toprule
    Macro & Result \\ 
    \midrule
   \verb|$\imath$| & $\imath$ \\ 
   \verb|$\mathrm{\imath}$| & $\mathrm{\imath}$ \\ 
    \verb|$\mathbf{\imath}$| & $\mathbf{\imath}$ \\ 
    \verb|$\mathbfit{\imath}$| & $\mathbfit{\imath}$ \\ 
    \bottomrule
  \end{tabular}
\end{center}
\item There are Greek alphabets in upright and italic shapes, regular and bold weights. Upright Greek letters have names like \verb|\alphaup| (and \verb|\upalpha|) while the italic forms have names like \verb|\alphait|. According to the options you set, \verb|\alpha| and so on are \verb|\let| to the appropriate choice, but you may always use the underlying forms if you wish to use both upright and italic forms in your document.
\item Uppercase Greek letters are of type {\tt mathalpha}, so when you write \verb|$\mathit{\Gamma}$|, you'll get~$\mathit{\Gamma}$. However, unless you chose the option {\tt lcgreekalpha}, \verb|$\mathrm{\beta}$| would produce $\mathrm{\beta}$, as it is of type {\tt mathord} by default.
\item There is an upright partial derivative symbol named \verb|\uppartial| that typesets as $\uppartial$, for those who wish to follow ISO rules.
\item There are (as of version 1.0.6) macros for mathematical sans serif: \verb|\mathsf|, \verb|\mathsfit| (italic sans) and \verb|\mathbfsf| (bold sans.)
\end{itemize}
The next pages show the font tables for LibertinusT1Math. If you see an unfamiliar symbol and wish to learn its \LaTeX\ name, get the \LaTeX\ name of the font (e.g., {\tt operators}, {\tt letters}, {\tt symbols}, {\tt largesymbols}) and the hex location of the glyph (e.g., \verb|"FF| is hex notation for $255$) and search {\tt libertinust1math.sty} by hex number.
\newpage
{\tt libertinust1-mathrm (operators):}
\fonttable{libertinust1-mathrm} 
\newpage
{\tt libertinust1-mathrm (bold-operators):}
\fonttable{libertinust1-mathrm-bold} 
\newpage
{\tt libertinust1-mathit (letters):}
\fonttable{libertinust1-mathit} 
\newpage
{\tt libertinust1-mathit-bold (bold-letters):}
\fonttable{libertinust1-mathit-bold} 
\newpage
{\tt libertinust1-mathsym (symbols):}
\fonttable{libertinust1-mathsym} 
\newpage
{\tt libertinust1-mathex (largesymbols):}
\fonttable{libertinust1-mathex} 
\newpage
{\tt libertinust1-mathbb (mathbb):}
\fonttable{libertinust1-mathbb} 
\newpage
{\tt libertinust1-mathsf (mathsf):}
\fonttable{libertinust1-mathsf} 
\end{document}