From 4ce3a0d4729af1865e66c9c1cd967f42b0830d26 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Sun, 24 Nov 2019 03:00:49 +0000
Subject: CTAN sync 201911240300

---
 .../latex/contrib/fontsetup/doc/fontsetup-doc.tex  | 261 +++++++++++++++++++++
 1 file changed, 261 insertions(+)
 create mode 100644 macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex

(limited to 'macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex')

diff --git a/macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex b/macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex
new file mode 100644
index 0000000000..80224d5f70
--- /dev/null
+++ b/macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex
@@ -0,0 +1,261 @@
+\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{21} November \textsc{2019}\\[1ex]
+	  Version 1.000, \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, which is an assembly of cm fonts plus
+    more fonts to support Greek (cbgreek) and Cyrillic languages.
+  \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. Stix2 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
+      MinionGreekSmallCaps.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[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
+      PalatinoGreekSmallCaps.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|MinionGreekSmallcaps.otf|
+  and \verb|PalatinoGreekSmallCaps.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-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 Stix2Math: 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 MinionGreekSmallCaps.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 PalatinoGreekSmallCaps.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}
-- 
cgit v1.2.3

