summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex
blob: 595db34e5edf717de8c35183030124b71652d170 (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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
\documentclass{article}
\usepackage[default]{fontsetup}
\usepackage{graphicx,fullpage}
\begin{document}


  \begin{center}
    {\LARGE The \texttt{fontsetup} package}\\[1ex]
    \textit{by}\\[1ex]
    {\large Antonis Tsolomitis}\\
University of the Aegean\\ Department of Mathematics\\[1ex]
	  \textsc{24} June \textsc{2020}\\[1ex]
	  Version 1.004, \textsc{gpl3}
  \end{center}

  This package is a simple wrapper-type package that makes the setup of fonts easy and
  quick for XeLaTeX and LuaLaTeX. You just load the package using one of the supported
  fonts as an option.

  The target is to provide easy access to fonts with a matching Mathematics font available in
  TeX distributions plus a few commercial if available.

  The package will include more font combinations in the future, however there are
  some restrictions. The fonts must have some commercial-level quality and must support
  Mathematics.
  
  The options (in alphabetic order) are as follows:

  \begin{description}
  \item[cambria] Loads the Cambria fonts of Microsoft. These must be already installed
    as a system font (in \verb|C:\Windows\Fonts| in MS-Windows, in \verb|/home/user/.fonts/| in Linux
    or elsewhere by the system administratior). 
  \item[default] Loads the NewComputerModern fonts (in Book weight),
    which is an assembly of cm fonts plus
    more fonts to support Greek (cbgreek) and Cyrillic languages. It also provides
    \begin{itemize}
      \item commands to access prosgegrammeni instead of ypogegrammeni for capitals and small
        capitals, by writing \verb|\textprosgegrammeni{<text>}| or \verb|{\prosgegrammeni <text>}|.
      \item commands to access 4th and 6th century bce Greek by writing
        \verb|\textivbce{<text>}| or \verb|{\ivbce <text>}| and
        \verb|\textvibce{<text>}| or \verb|{\vibce <text>}|. For example, write
        \verb|\textivbce{ΕΠΙΚΟΥΡΟΣ}| to get \textivbce{ΕΠΙΚΟΥΡΟΣ}.
      \item commands to access Sans Greek (upright and oblique) in math mode although these are
        not included in the unicode standard. The commands follow the unicode-math.sty notation, so
        to get $\msansLambda$ and $\mitsanspi$ you write \verb|$\msansLambda$| and \verb|$\mitsanspi$|.
      \end{itemize}
  \item[ebgaramond] Loads the EB-Garamond fonts with Garamond-Math.
    \item[fira] Loads the Fira family, a sans-serif font.
    \item[gfsartemisia] Loads the GFSArtemisia, a font family designed to be used
      as a Times replacement. The Mathematics is from stix2 but latin
      and greek letters are substituted from GFSArtemisia to provide a better match.
    \item[gfsdidotclassic] Uses the GFSDidotClassic for Greek with GFSPorson for italic.
      The latin part is URW garamond. The Mathematics is from Garamond-Math but the greek
      letters are substituted from GFSDidotClassic to provide a better match. Notice that
      the Bold versions of the Greek fonts are faked using fontspec mechanism as
      the Greek part does not have bold versions.
    \item[gfsdidot] Loads the GFSDidot fonts. NewCMMath-Book is the Mathematics font, but latin
      and greek letters are substituted from GFSdidot to provide a better match.
    \item[gfsneohellenic] Loads the GFSNeohellenic family with GFSNeohellenic-Math.
    \item[kerkis] Loads the kerkis font family and texgyrebonum-math.
    \item[libertinus] Loads the Libertinus and LibertinusMath fonts.
    \item[lucida] Loads the Lucida font family if available (a commercial font).
    \item[minion] Loads the MinionPro family. To install it, find the fonts MinionPro and
      MyriadPro from the installation of Adobe PDF Reader and install the fonts to your system
      (in \verb|C:\Windows\Fonts| in MS-Windows, in \verb|/home/user/.fonts/| in Linux
      or elsewhere by the system administratior). Moreover, install the supplied
      fspmnscel.otf as a system font to have access to Greek small caps.
      Mathematics is from stix2
      with letters replaced from MinionPro. Sans is MyriadPro.
    \item[msgaramond] Loads the MS-Garamond fonts. These must be system installed
      (in \verb|C:\Windows\Fonts| in MS-Windows, in \verb|/home/user/.fonts/| in Linux
      or elsewhere by the system administratior). Mathematics is from
      Garamond-Math with letters replaced
      from MS-Garamond.
    \item[neoeuler] Loads the Concrete fonts with the Euler for Mathematics. 
      Needs euler.otf to be instaled in the TeX installation.
    \item[olddefault] Loads the NewComputerModern fonts (in Regular weight),
    \item[palatino] Loads the Linotype Palatino Fonts available from some versions of Windows.
      Thefonts must be system installed (in \verb|C:\Windows\Fonts| in MS-Windows,
      in \verb|/home/user/.fonts/| in Linux or elsewhere by the system administratior). The supplied
      fsplpscel.otf must be also
      system-installed to allow access to Greek small caps.
      Mathematics font is texgyrepagella-math.
    \item[stixtwo] Loads the stix2 fonts, a Times-type font.
    \item[times] Loads the FreeSerifb fonts, a Times font and stix2 for Mathematics
      with letters replaced from FreeSerifb.
  \end{description}

  You do not need to load \verb|fontspec|. This, as well as \verb|unicode-math|, are
  automatically loaded. A minimal file is
\begin{verbatim}
  \documentclass{article}
  \usepackage[default]{fontsetup}
  \begin{document}
  ...
  \end{document}
\end{verbatim}

The switch to another font is trivial. You just change the option of \verb|fontsetup|
to another among the supported ones.


\bigskip

\textbf{Summary of installation steps to support all fonts}

\medskip

You do not have to do any of these steps if you rely on free fonts
(except step 6 if you want to use the \verb|neoeuler| option) and do not want
to use the commercial ones.

\medskip

\begin{enumerate}
\item Install as system fonts the supplied \verb|fspmnscel.otf|
  and \verb|fsplpscel.otf| (in \verb|C:\Windows\Fonts\| on MS-Windows or in
  \verb|/home/user/.fonts/| in Linux or system-wide install as administrator)
\item Repeat the previous step for all MinionPro and MyriadPro fonts from the
  installation of the free Adobe Acrobat Reader.
\item Repeat the above for the MS-Garamond fonts (\verb|Gara.ttf|, \verb|Garabd.ttf|
  and \verb|Garait.ttf|) as well as for the Linotype Palatino fonts
  found in some versions of Microsoft Windows (\verb|palabi.ttf|, \verb|palab.ttf|,
  \verb|palai.ttf|, and \verb|pala.ttf|).
\item Repeat the above for the Cambria fonts (\verb|cambria.ttc|, \verb|cambriab.ttf|,
  \verb|cambriai.ttf|, \verb|cambriaz.ttf|).
\item Install the commercial Lucida fonts (if available) in your TeX tree.
\item Install \verb|euler.otf| in your TeX tree from
  here: \verb|https://github.com/khaledhosny/euler-otf|
\end{enumerate}

\bigskip




You can indeed suggest a new combination of fonts and I will add them. However, I do
reserve the right to reject them if the font quality is bad or if Mathematics is not supported
with a matching font.

Samples follow.

\newpage

\begin{center}
{\Large Cambria and CambriaMath: option \verb|cambria|}\\
Cambria Fonts must be installed as system fonts\\[1cm] 
\includegraphics[scale=1.2]{fspsample-cambria.pdf}
\end{center}

\newpage

\begin{center}
{\Large ComputerModern fonts: option \verb|default|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-newdefault.pdf}
\end{center}
\newpage

\begin{center}
{\Large ComputerModern fonts (Book weight): option \verb|olddefault|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-cmr.pdf}
\end{center}

\newpage

\begin{center}
{\Large EB-Garamond and Garamond-Math fonts: option \verb|ebgaramond|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-ebgaramond.pdf}
\end{center}

\newpage

\begin{center}
{\Large Fira fonts: option \verb|fira|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-fira.pdf}
\end{center}

\newpage

\begin{center}
{\Large GFSArtemisia and Stix2Math fonts: option \verb|gfsartemisia|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-gfsartemisia.pdf}
\end{center}

\newpage

\begin{center}
{\Large GFSDidotClassic, GFSPorson Italic, and Garamond-Math fonts: option \verb|gfsdidotclassic|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-gfsdidotclassic.pdf}
\end{center}

\newpage

\begin{center}
{\Large GFSDidot and NewCMMath-Book: option \verb|gfsdidot|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-gfsdidot.pdf}
\end{center}

\newpage

\begin{center}
{\Large GFSNeohellenic and GFSNeohellenic-Math: option \verb|gfsneohellenic|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-gfsneohellenic.pdf}
\end{center}

\newpage

\begin{center}
{\Large Kerkis and texgyrebonum-math: option \verb|kerkis|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-kerkis.pdf}
\end{center}



\newpage

\begin{center}
{\Large Libertinus and LibertinusMath: option \verb|libertinus|}\\[1cm]
\includegraphics[scale=1.2]{fspsample-libertinus.pdf}
\end{center}



\newpage

\begin{center}
{\Large Lucida and Lucida-Math (commercial): option \verb|lucida|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-lucida.pdf}
\end{center}

\newpage

\begin{center}
{\Large MinionPro (commercial) and Stix2Math: option \verb|minion|}\\
MinionPro Fonts and the supplied fspmnscel.otf must
be installed as system fonts\\[1cm] 
\includegraphics[scale=1.2]{fspsample-minion.pdf}
\end{center}

\newpage

\begin{center}
{\Large MS-Garamond (commercial) and Garamond-Math: option \verb|msgaramond|}\\
MS-Garamond Fonts must be installed as system fonts\\[1cm] 
\includegraphics[scale=1.2]{fspsample-msgaramond.pdf}
\end{center}

\newpage

\begin{center}
{\Large Concrete fonts and NeoEuler Math: option \verb|neoeuler|}\\
NeoEuler font must be installed in TeX tree\\[1cm] 
\includegraphics[scale=1.2]{fspsample-neoeuler.pdf}
\end{center}

\newpage

\begin{center}
{\Large Linotype Palatino (commercial) and texgyrepagella-math: option \verb|palatino|}\\
Linotype Palatino Fonts and the supplied fsplpscel.otf must be installed as system fonts\\[1cm] 
\includegraphics[scale=1.2]{fspsample-palatino.pdf}
\end{center}

\newpage

\begin{center}
{\Large Stix2 and Stix2Math: option \verb|stixtwo|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-stixtwo.pdf}
\end{center}

\newpage

\begin{center}
{\Large FreeSerifb and Stix2Math: option \verb|times|}\\[1cm] 
\includegraphics[scale=1.2]{fspsample-times.pdf}
\end{center}




    
\end{document}