summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-11-24 03:00:49 +0000
committerNorbert Preining <norbert@preining.info>2019-11-24 03:00:49 +0000
commit4ce3a0d4729af1865e66c9c1cd967f42b0830d26 (patch)
tree72eb6f1bfdde6ea4d196d2ee18e43df324be86ff /macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex
parentce62a0079d7ae24531c203f5758502c163280ff7 (diff)
CTAN sync 201911240300
Diffstat (limited to 'macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex')
-rw-r--r--macros/latex/contrib/fontsetup/doc/fontsetup-doc.tex261
1 files changed, 261 insertions, 0 deletions
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}