summaryrefslogtreecommitdiff
path: root/macros/unicodetex/latex/fontsetup/doc/fontsetup-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/unicodetex/latex/fontsetup/doc/fontsetup-doc.tex')
-rw-r--r--macros/unicodetex/latex/fontsetup/doc/fontsetup-doc.tex339
1 files changed, 339 insertions, 0 deletions
diff --git a/macros/unicodetex/latex/fontsetup/doc/fontsetup-doc.tex b/macros/unicodetex/latex/fontsetup/doc/fontsetup-doc.tex
new file mode 100644
index 0000000000..b9ddc3ddcd
--- /dev/null
+++ b/macros/unicodetex/latex/fontsetup/doc/fontsetup-doc.tex
@@ -0,0 +1,339 @@
+\documentclass{book}
+\usepackage[default]{fontsetup}
+\usepackage{graphicx,fullpage,supertabular}
+\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} August \textsc{2020}\\[1ex]
+ Version 1.007, \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 after the default option) are as follows:
+
+ \begin{description}
+ \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$|.
+ \item commands to access the Ancient Greek Numbers (Unicode u10140--u1018E)
+ documented in the Appendix
+ \item commands to access the negation of uniform convergence symbols \verb|\nrightrightarrows|
+ for $\nrightrightarrows$ and \verb|\nleftleftarrows| for $\nleftleftarrows$.
+ \item commands to access the IPA symbols. These are \verb|\ipatext| and \verb|\ipatextsans|
+ to select the fonts properly or \verb|\textipa{...}| and \verb|\textsansipa{...}| to select the fonts
+ for IPA symbols locally. Compare \textipa{ðŋβθχ}
+ (produced with \verb|\textipa{ðŋβθχ}|) with ðŋβθχ.
+ \end{itemize}
+ \item[olddefault] Loads the NewComputerModern fonts (in Regular weight)
+ similarly to the default option.
+ \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[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[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 (Book weight): option \verb|default|}\\[1cm]
+\includegraphics[scale=1.2]{fspsample-newdefault.pdf}
+\end{center}
+\newpage
+
+\begin{center}
+{\Large ComputerModern fonts (old Regular 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}
+
+\appendix
+
+\chapter{Ancient Greek Numbers}
+The following table lists the commands and the symbol produced for the Unicode range
+\texttt{u10140--u1018E}.
+\begin{center}\enlargethispage{1cm}
+ \begin{supertabular}{|l|l||l|l|}
+ \hline
+\verb|\atticonequarter| & \atticonequarter &\verb|\hermionianfifty| & \hermionianfifty \\ \hline
+\verb|\atticonehalf| & \atticonehalf &\verb|\thespianfifty| & \thespianfifty \\ \hline
+\verb|\atticonedrachma| & \atticonedrachma &\verb|\thespianonehundred| & \thespianonehundred \\ \hline
+\verb|\atticfive| & \atticfive &\verb|\thespianthreehundred| & \thespianthreehundred \\ \hline
+\verb|\atticfifty| & \atticfifty &\verb|\epidaurianfivehundred| & \epidaurianfivehundred \\ \hline
+\verb|\atticfivehundred| & \atticfivehundred &\verb|\troezenianfivehundred| & \troezenianfivehundred \\ \hline
+\verb|\atticfivethousand| & \atticfivethousand &\verb|\thespianfivehundred| & \thespianfivehundred \\ \hline
+\verb|\atticfiftythousand| & \atticfiftythousand &\verb|\carystianfivehundred| & \carystianfivehundred \\ \hline
+\verb|\atticfivetalents| & \atticfivetalents &\verb|\naxianfivehundred| & \naxianfivehundred \\ \hline
+\verb|\attictentalents| & \attictentalents &\verb|\thespianonethousand| & \thespianonethousand \\ \hline
+\verb|\atticfiftytalents| & \atticfiftytalents &\verb|\thespianfivethousand| & \thespianfivethousand \\ \hline
+\verb|\atticonehundredtalents| & \atticonehundredtalents &\verb|\delphicfivemnas| & \delphicfivemnas \\ \hline
+\verb|\atticfivehundredtalents| & \atticfivehundredtalents &\verb|\stratianfiftymnas| & \stratianfiftymnas \\ \hline
+\verb|\atticonethousandtalents| & \atticonethousandtalents &\verb|\greekonehalfsign| & \greekonehalfsign \\ \hline
+\verb|\atticfivethousandtalents| & \atticfivethousandtalents &\verb|\greekonehalfsignalt| & \greekonehalfsignalt \\ \hline
+\verb|\atticfivestaters| & \atticfivestaters &\verb|\greektwothirdssign| & \greektwothirdssign \\ \hline
+\verb|\attictenstaters| & \attictenstaters &\verb|\greekthreequarterssign| & \greekthreequarterssign \\ \hline
+\verb|\atticfiftystaters| & \atticfiftystaters &\verb|\greekyearsign| & \greekyearsign \\ \hline
+\verb|\atticonehundredstaters| & \atticonehundredstaters &\verb|\greektalentsign| & \greektalentsign \\ \hline
+\verb|\atticfivehundredstaters| & \atticfivehundredstaters &\verb|\greekdrachmasign| & \greekdrachmasign \\ \hline
+\verb|\atticonethousandstaters| & \atticonethousandstaters &\verb|\greekobolsign| & \greekobolsign \\ \hline
+\verb|\attictenthousandstaters| & \attictenthousandstaters &\verb|\greektwoobolssign| & \greektwoobolssign \\ \hline
+\verb|\atticfiftythousandstaters| & \atticfiftythousandstaters &\verb|\greekthreeobolssign| & \greekthreeobolssign \\ \hline
+\verb|\attictenmnas| & \attictenmnas &\verb|\greekfourobolssign| & \greekfourobolssign \\ \hline
+\verb|\heraleumoneplethron| & \heraleumoneplethron &\verb|\greekfiveobolssign| & \greekfiveobolssign \\ \hline
+\verb|\thespianone| & \thespianone &\verb|\greekmetretessign| & \greekmetretessign \\ \hline
+\verb|\ermionianone| & \ermionianone &\verb|\greekkyathosbasesign| & \greekkyathosbasesign \\ \hline
+\verb|\epidauriantwo| & \epidauriantwo &\verb|\greeklytrasign| & \greeklytrasign \\ \hline
+\verb|\thespiantwo| & \thespiantwo &\verb|\greekounkiasign| & \greekounkiasign \\ \hline
+\verb|\cyrenaictwodrachmas| & \cyrenaictwodrachmas &\verb|\greekxestessign| & \greekxestessign \\ \hline
+\verb|\epidauriantwodrachmas| & \epidauriantwodrachmas &\verb|\greekartabesign| & \greekartabesign \\ \hline
+\verb|\troezenianfive| & \troezenianfive &\verb|\greekarourasign| & \greekarourasign \\ \hline
+\verb|\troezenianten| & \troezenianten &\verb|\greekgrammasign| & \greekgrammasign \\ \hline
+\verb|\troezeniantenalt| & \troezeniantenalt &\verb|\greektryblionbasesign| & \greektryblionbasesign \\ \hline
+\verb|\hermionianten| & \hermionianten &\verb|\greekzerosign| & \greekzerosign \\ \hline
+\verb|\messenianten| & \messenianten &\verb|\greekonequartersign| & \greekonequartersign \\ \hline
+\verb|\thespianten| & \thespianten &\verb|\greeksinusoidsign| & \greeksinusoidsign \\ \hline
+\verb|\thespianthirty| & \thespianthirty &\verb|\greekindictionsign| & \greekindictionsign \\ \hline
+\verb|\troezenianfifty| & \troezenianfifty &\verb|\nomismasign| & \nomismasign \\ \hline
+\verb|\troezenianfiftyalt| & \troezenianfiftyalt & & \\ \hline
+ \end{supertabular}
+\end{center}
+
+
+\end{document}