diff options
Diffstat (limited to 'Master/texmf-dist/doc/fonts/euler-math/Euler-Math.ltx')
| -rw-r--r-- | Master/texmf-dist/doc/fonts/euler-math/Euler-Math.ltx | 449 |
1 files changed, 449 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/fonts/euler-math/Euler-Math.ltx b/Master/texmf-dist/doc/fonts/euler-math/Euler-Math.ltx new file mode 100644 index 00000000000..b187c488696 --- /dev/null +++ b/Master/texmf-dist/doc/fonts/euler-math/Euler-Math.ltx @@ -0,0 +1,449 @@ +\RequirePackage{pdfmanagement-testphase} +\DeclareDocumentMetadata{pdfstandard=A-2b, lang=en-GB} +\documentclass[a4paper,12pt]{scrartcl} + +\usepackage{amsmath, array, varioref} +\usepackage[british]{babel} +\usepackage{fourier-orns} +\usepackage{euler-math} +\setmainfont{cmunorm.otf} + [BoldFont = cmunobx.otf , + ItalicFont = cmunoti.otf , + BoldItalicFont = cmunobi.otf + ] +\setsansfont{Cabin}[Scale=MatchLowercase] +\setmonofont{Inconsolatazi4}[Scale=MatchLowercase,StylisticSet={2,3}] +\usepackage{subfig} +\captionsetup[subtable]{position=top} +\usepackage{realscripts} +\usepackage{microtype} +\usepackage{hyperref} +\hypersetup{pdftitle={Euler-Math User’s Guide}, + pdfauthor={Daniel FLIPO}, + bookmarksopen, + colorlinks + } +\newcommand*{\hlabel}[1]{\phantomsection\label{#1}} + +\newcommand*{\NEOTF}{Euler-Math} +\newcommand*{\pkg}[1]{\texttt{#1}} +\newcommand*{\file}[1]{\texttt{#1}} +\newcommand*{\opt}[1]{\texttt{#1}} +\newcommand*{\cmd}[1]{\texttt{\textbackslash #1}}\newcommand*{\showtchar}[1]{\cmd{#1}~\csname #1\endcsname} +\newcommand*{\showmchar}[1]{\cmd{#1}~$(\csname #1\endcsname)$} +\newcommand*{\showmchardollar}[1]{\texttt{\$\cmd{#1}\$}~$(\csname #1\endcsname)$} + +\renewcommand{\labelitemi}{\lefthand} + +\title{Euler Math font, OTF version} +\author{Daniel Flipo \\ \texttt{daniel.flipo@free.fr}} + +\newcommand*{\version}{0.30} + +\begin{document} +\maketitle + +\section{What is \NEOTF{}?} + +\NEOTF{} is a fork of the Euler project initiated by Khaled Hosny in 2009 +and abandoned in 2016% +\footnote{See \url{https://github.com/aliftype/euler-otf}}. +The original font name `Neo~Euler’, has been changed to `Euler~Math’, the file +name is now \file{Euler-Math.otf}. + +\file{Euler-Math.otf} is an OpenType version of Hermann Zapf’s Euler maths font, +as the original font it contains three alphabets $Euler Roman$, +$\symscr{SCRIPT}$ and $\symfrak{Euler Fraktur}$ (none of them being suitable +for typesetting text) and has some specificities: +\begin{itemize} +\item it is an \emph{upright} maths font, Latin and Greek letters are + \emph{not available} in italic or bold italic shape (only upright and bold) ; +\item integral symbols are upright too; +\item all inequalities symbols are \emph{slanted}, so \cmd{leq} and geq are + printed as $\leq$ and $\geq$ (same as \cmd{leqslant} and \cmd{geqslant}). +\end{itemize} + +\NEOTF{} requires LuaTeX or XeTeX as engine and the \pkg{unicode-math} package% +\footnote{Please read the documentation \file{unicode-math.pdf}.}. + +Coverage: currently, all Plain, LaTeX and AMS maths symbols are provided; sans +serif and typewriter families of Latin and Greek letters and digits are not +included. + +Please note that the current version (\version) is \emph{experimental, +do expect metrics and glyphs to change} until version 1.0 is reached. +Comments, suggestions and bug reports are welcome! + +\pagebreak[4] +\section{Usage} + +\subsection{Calling \cmd{setmathfont}} + +A basic call for \NEOTF{} would be: +\begin{verbatim} +\usepackage[math-style=upright]{unicode-math} +\setmathfont{Euler-Math.otf} % Call by file name or +\setmathfont{Euler Math} % Call by font name or +\end{verbatim} +this loads \NEOTF{} as maths font% +\footnote{Both calls work equally well with LuaTeX; with XeTeX a call by font + name will fail unless the font is declared as a \emph{system font}.} + with the default options, see subsections~\ref{ssection-cv}, + \ref{ssection-ss} and~\ref{ssec-other-features} for customisation. + +Please note that the three sets of text fonts have to be chosen separately. + +\subsection{Calling \pkg{euler-math.sty} (recommended)} + +As an alternative to load \NEOTF{} you can type:\\[.5\baselineskip] +\verb+\usepackage{euler-math}+\\[.5\baselineskip] +\verb+\usepackage[ +\textit{options} +\footnote{Possible \textit{options} are \opt{Scale=} or any of the options + described in sections \ref{ssection-cv}, \ref{ssection-ss} and + \ref{ssec-other-features}.}% +\verb+ ]{euler-math}+\\[.5\baselineskip] +it loads \pkg{unicode-math} with the \opt{math-style=upright} option and +sets Euler-Math as maths font but does a bit more: +\begin{enumerate} +\item it checks at \verb+\begin{document}+ if packages \pkg{amssymb} or + \pkg{latexsym} are loaded and issues warnings in case they are; +\item it provides aliases for glyphs named differently in Unicode, so that + \pkg{latexsym} or AMS names are also available; +\item it defines some specific maths characters \showmchar{varemptyset}, etc. +\end{enumerate} + +The \pkg{euler-math.sty} package is meant to replace the \pkg{eulervm.sty} +package for users switching from pdfLaTeX to LuaLaTeX or XeLaTeX. +It does not interfere with text fonts which have to be chosen separately. + +\section{What is provided?} + +\NEOTF{} provides all glyphs available in the \pkg{amssymb} and \pkg{latexsym} +packages and many more, f.i. lots of extensible accents and arrows. + +These two packages \emph{should not} be loaded as they might override \NEOTF{} +glyphs. + +As mentioned above, there is neither italic nor bold italic shapes. +Furthermore, the font has currently no sans-serif, no typewriter family +included. Fraktur and Blackboard Bold styles are included. +See in section~\vref{ssec-math-alphabets} how to choose +from other maths fonts if sans-serif or typewriter glyphs are needed. + +A full list of available glyphs is shown in file \file{unimath-euler.pdf}. + +\subsection{Character variants} +\label{ssection-cv} + +\NEOTF{} provides fourteen ``Character Variants’’ options, listed on +table~\vref{cv}, to choose between different glyphs for Greek characters +and some others. +\begin{table}[ht] + \centering \caption{Character variants.} + \hlabel{cv} + \begin{tabular}{@{}>{\ttfamily}lccl@{}} + \hline + & Default & Variant & Name\\ + \hline + cv01 & $\hslash$ & $\muphbar$ & \cmd{hslash} \\ + cv02 & $\emptyset$ & $\varemptyset$ & \cmd{emptyset} \\ + cv03 & $\epsilon$ & $\varepsilon$ & \cmd{epsilon} \\ + cv04 & $\kappa$ & $\varkappa$ & \cmd{kappa} \\ + cv05 & $\pi$ & $\varpi$ & \cmd{pi} \\ + cv06 & $\phi$ & $\varphi$ & \cmd{phi} \\ + cv09 & $\theta$ & $\vartheta$ & \cmd{theta} \\ + cv10 & $\Theta$ & $\varTheta$ & \cmd{Theta}\\ + \hline + \end{tabular} +\end{table} + +For instance, to get \cmd{epsilon} and \cmd{phi} typeset as $\varepsilon$ +and $\varphi$ instead of $\epsilon$ and $\phi$ (with matching bold variants +$\symbf{\varepsilon}$ and $\symbf{\varphi}$), you can +add option \verb+CharacterVariant={3,6}+ to the \cmd{setmathfont} call: +\begin{verbatim} +\setmathfont{Euler-Math.otf}[CharacterVariant={3,6}] +\end{verbatim} + +Please note that curly braces are mandatory whenever more than one +``Character Variant’’ is selected. + +Note about \cmd{hbar}: \pkg{unicode-math} defines \cmd{hbar} as +\cmd{hslash} (U+210F) while \pkg{amsmath} provides two different glyphs +(h with horizontal or diagonal stroke).\\ +\pkg{euler-math} follows \pkg{unicode-math}; the h with horizontal +stroke can be printed using \cmd{hslash} or \cmd{hbar} together with character +variant \opt{cv01} or with \cmd{muphbar} (replacement for AMS’ command +\cmd{hbar}). + +\subsection{Stylistic sets} +\label{ssection-ss} + +\NEOTF{} provides two ``Stylistic Sets’’ options to choose between different +glyphs for families of maths symbols. + +\verb+StylisticSet=5+, alias \verb+Style=smaller+, converts some symbols into +their smaller variants, see table~\vref{ss05}. + +\verb+StylisticSet=6+, alias \verb+Style=subsetneq+, converts some inclusion +symbols, see table~\vref{ss06}. +\begin{table}[ht] + \centering + \caption{Stylistic Sets 5 and 6} + \subfloat[\opt{Style=smaller\quad (+ss05)}]{\hlabel{ss05}% + \begin{tabular}[t]{@{}lcc@{}} + \hline + Command & Default & Variant \\ + \hline + \cmd{in} & $\in$ & $\smallin$ \\ + \cmd{ni} & $\ni$ & $\smallni$ \\ + \cmd{mid} & $\mid$ & $\shortmid$ \\ + \cmd{nmid} & $\nmid$ & $\nshortmid$ \\ + \cmd{parallel} & $\parallel$ & $\shortparallel$ \\ + \cmd{nparallel} & $\nparallel$ & $\nshortparallel$ \\ + \hline + \end{tabular} + }\hspace{10mm} % eof subfloat + \subfloat[\opt{Style=subsetneq\quad (+ss06)}]{\hlabel{ss06}% + \begin{tabular}[t]{@{}lcc@{}} + \hline + Command & Default & Variant \\ + \hline + \cmd{subsetneq} & $\subsetneq$ & $\varsubsetneq$ \\ + \cmd{supsetneq} & $\supsetneq$ & $\varsupsetneq$ \\ + \cmd{subsetneqq} & $\subsetneqq$ & $\varsubsetneqq$ \\ + \cmd{supsetneqq} & $\supsetneqq$ & $\varsupsetneqq$ \\ + \hline + \end{tabular} + }% eof subfloat +\end{table} + + +To enable Stylistic Sets 5 and 6 for \NEOTF{}, you should enter +\begin{verbatim} +\setmathfont{Euler-Math.otf}[StylisticSet={5,6}] or +\usepackage[Style={smaller,subsetneq}]{Euler-Math.otf} +\end{verbatim} +{\samepage then, \verb+\[A \subsetneq B\quad x \in E \quad D \parallel D' \]+ +will print as +\setmathfont{Euler-Math.otf}[StylisticSet={5,6}] +\[A \subsetneq B\quad x \in E \quad D \parallel D' \] +instead of +\setmathfont{Euler-Math.otf} +\[A \subsetneq B\quad x \in E \quad D \parallel D' \] +} + +\subsection{Other font features} +\label{ssec-other-features} + +To get oldstyle numbers in maths, the feature \opt{+onum} is available: +\begin{verbatim} +\setmathfont{Euler-Math.otf}[Numbers=OldStyle] or +\usepackage[Style={fulloldstyle}]{euler-math} +\end{verbatim} + +\setmathfont{Euler-Math.otf}[Numbers=OldStyle] +$0123456789, \symbf{0123456789}$ +\setmathfont{Euler-Math.otf} + +\subsection{Standard \LaTeX{} math commands} +\label{ssec-math-commands} + +All standard \LaTeX{} maths commands, all \pkg{amssymb} commands and all +\pkg{latexsym} commands are supported by \NEOTF{}, for some of them loading +\pkg{euler-math.sty} is required. + +Various wide accents are also supported: +\begin{itemize} +\item \cmd{wideoverbar} and \cmd{mathunderbar}% + \footnote{\cmd{overline} and \cmd{underline} are not font related, + they are based on \cmd{rule}.} + \[\wideoverbar{x}\quad \wideoverbar{xy}\quad \wideoverbar{xyz}\quad + \wideoverbar{A\cup B}\quad \wideoverbar{A\cup (B\cap C)\cup D}\quad + \mathunderbar{m+n+p}\] + +\item \cmd{widehat} and \cmd{widetilde} +\[\widehat{x}\; \widehat{xx} \;\widehat{xxx} \;\widehat{xxxx}\; + \widehat{xxxxx} \;\widehat{xxxxxx} \;\widetilde{x}\; \widetilde{xx}\; + \widetilde{xxx} \;\widetilde{xxxx} \;\widetilde{xxxxx}\; + \widetilde{xxxxxx}\] + +\item \cmd{widecheck} and \cmd{widebreve} + \[\widecheck{x}\quad \widecheck{xxxx}\quad \widecheck{xxxxxx}\quad + \widebreve{x}\quad \widebreve{xxxx}\quad \widebreve{xxxxxx}\] + +\item \cmd{overparen} and \cmd{underparen} + \[\overparen{x}\quad \overparen{xy}\quad \overparen{xyz}\quad + \mathring{\overparen{A\cup B}}\quad + \overparen{A\cup (B\cap C)\cup D}^{\smwhtcircle}\quad + \overparen{x+y}^{2}\quad \overparen{a+b+...+z}^{26}\] +\vspace{-\baselineskip} +\[\underparen{x}\quad \underparen{xz} \quad \underparen{xyz} + \quad \underparen{x+z}_{2}\quad \underparen{a+b+...+z}_{26}\] + +\item \cmd{overbrace} and \cmd{underbrace} + \[\overbrace{a}\quad \overbrace{ab}\quad \overbrace{abc}\quad + \overbrace{abcd}\quad \overbrace{abcde}\quad + \overbrace{a+b+c}^{3}\quad \overbrace{ a+b+. . . +z }^{26}\] + \vspace{-\baselineskip} + \[\underbrace{a}\quad\underbrace{ab}\quad\underbrace{abc}\quad + \underbrace{abcd}\quad \underbrace{abcde}\quad + \underbrace{a+b+c}_{3} \quad \underbrace{ a+b+...+z }_{26}\] + +\item \cmd{overbracket} and \cmd{underbracket} + \[\overbracket{a}\quad \overbracket{ab}\quad \overbracket{abc}\quad + \overbracket{abcd}\quad \overbracket{abcde}\quad + \overbracket{a+b+c}^{3}\quad \overbracket{ a+b+. . . +z }^{26}\] + \vspace{-\baselineskip} + \[\underbracket{a}\quad\underbracket{ab}\quad\underbracket{abc}\quad + \underbracket{abcd}\quad \underbracket{abcde}\quad + \underbracket{a+b+c}_{3} \quad \underbracket{ a+b+...+z }_{26}\] + +\item \cmd{overrightarrow}, \cmd{overleftarrow} and \cmd{overleftrightarrow} + \[\overrightarrow{v}\quad \overrightarrow{M}\quad \overrightarrow{vv} + \quad \overrightarrow{AB}\quad \overrightarrow{ABC} + \quad \overrightarrow{ABCD} \quad \overrightarrow{ABCDEFGH}. + \] + \vspace{-\baselineskip} + \[\overleftarrow{v}\quad \overleftarrow{M}\quad \overleftarrow{vv} + \quad \overleftarrow{AB}\quad \overleftarrow{ABC} + \quad \overleftarrow{ABCD} \quad \overleftarrow{ABCDEFGH}\] + \vspace{-\baselineskip} + \[\overleftrightarrow{v}\quad \overleftrightarrow{M}\quad + \overleftrightarrow{vv}\quad + \overleftrightarrow{AB}\quad \overleftrightarrow{ABC}\quad + \overleftrightarrow{ABCD} \quad \overleftrightarrow{ABCDEFGH}\] + +\item \cmd{overrightharpoon} and \cmd{overleftharpoon} + \[\overrightharpoon{v}\quad \overrightharpoon{M}\quad \overrightharpoon{vv} + \quad \overrightharpoon{AB}\quad \overrightharpoon{ABC} + \quad \overrightharpoon{ABCD} \quad \overrightharpoon{ABCDEFGH}. + \] + \vspace{-\baselineskip} + \[\overleftharpoon{v}\quad \overleftharpoon{M}\quad \overleftharpoon{vv} + \quad \overleftharpoon{AB}\quad \overleftharpoon{ABC} + \quad \overleftharpoon{ABCD} \quad \overleftharpoon{ABCDEFGH}\] + +\item \cmd{underrightarrow}, \cmd{underleftarrow} and \cmd{underleftrightarrow} + \[\underrightarrow{v}\quad \underrightarrow{M}\quad \underrightarrow{vv} + \quad \underrightarrow{AB}\quad \underrightarrow{ABC} + \quad \underrightarrow{ABCD} \quad \underrightarrow{ABCDEFGH}. + \] + \vspace{-\baselineskip} + \[\underleftarrow{v}\quad \underleftarrow{M}\quad \underleftarrow{vv} + \quad \underleftarrow{AB}\quad \underleftarrow{ABC} + \quad \underleftarrow{ABCD} \quad \underleftarrow{ABCDEFGH}\] + \vspace{-\baselineskip} + \[\underleftrightarrow{v}\quad \underleftrightarrow{M}\quad + \underleftrightarrow{vv}\quad + \underleftrightarrow{AB}\quad \underleftrightarrow{ABC}\quad + \underleftrightarrow{ABCD} \quad \underleftrightarrow{ABCDEFGH}\] + +\item \cmd{underrightharpoondown} and \cmd{underleftharpoondown} + \[\underrightharpoondown{v} \quad \underrightharpoondown{M}\quad + \underrightharpoondown{vv}\quad \underrightharpoondown{AB}\quad + \underrightharpoondown{ABC}\quad \underrightharpoondown{ABCD} + \quad \underrightharpoondown{ABCDEFGH}. + \] + \vspace{-\baselineskip} + \[\underleftharpoondown{v} \quad \underleftharpoondown{M}\quad + \underleftharpoondown{vv}\quad \underleftharpoondown{AB}\quad + \underleftharpoondown{ABC}\quad \underleftharpoondown{ABCD} + \quad \underleftharpoondown{ABCDEFGH}. + \] + +\item Finally \cmd{widearc} and \cmd{overrightarc} (loading + \pkg{euler-math.sty} is required) +\[\widearc{AMB}\quad \overrightarc{AMB}\] +\end{itemize} + +\subsection{Mathematical alphabets} +\label{ssec-math-alphabets} + +\begin{itemize} +\item All Latin and Greek characters are available in upright + and bold via the \verb+\symup{}+ and \verb+\symbf{}+ commands. + +\item Calligraphic alphabet (\cmd{symscr} or \cmd{symcal} or + \cmd{mathcal} command), uppercase:\\ + $\symscr{ABCDEFGHIJKLMNOPQRSTUVWXYZ}$\\ + also in boldface (\cmd{symbfscr},\cmd{symbfcal} or \cmd{mathbfcal} command):\\ + $\symbfscr{ABCDEFGHIJKLMNOPQRSTUVWXYZ}$ + +\item Blackboard-bold alphabet (\cmd{symbb} or \cmd{mathbb} command), + uppercase, lowercase and digits: + + $\symbb{ABCDEFGHIJKLMNOPQRSTUVWXYZ}$ + + $\symbb{abcdefghijklmnopqrstuvwxyz\quad 0123456789}$ + +\item Fraktur alphabet medium and bold + (\cmd{symfrak}, or \cmd{symbffrak} commands): + + $\symfrak{ABCDEFGHIJKLMNOPQRSTUVWXYZ\quad abcdefghijklmnopqrstuvwxyz}$\\ + $\symbffrak{ABCDEFGHIJKLMNOPQRSTUVWXYZ}$\\ + \hphantom{$\symfrak{ABCDEFGHIJKLMNOPQRSTUVWXYZ\quad}$}% + $\symbffrak{abcdefghijklmnopqrstuvwxyz}$ + +\item Sans serif and Typewriter alphabets have to be imported from another + math font, f.i. \file{STIXTwoMath}: +\begin{verbatim} +\setmathfont{STIXTwoMath-Regular.otf}[range=sfup,Scale=MatchUppercase] +$\symsfup{ABCD...klm}$ +\end{verbatim} +\setmathfont{STIXTwoMath-Regular.otf}[range=sfup,Scale=MatchUppercase] +$\symsfup{ABCDEFGHIJKLM abcdefghijklm}$ + +\begin{verbatim} +\setmathfont{STIXTwoMath-Regular.otf}[range=tt,Scale=MatchUppercase] +$\symtt{ABCDE...XYZ abcde...xyz}$ +\end{verbatim} +\setmathfont{STIXTwoMath-Regular.otf}[range=tt,Scale=MatchUppercase] +$\symtt{ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz}$ +\end{itemize} + + +\subsection{Missing symbols} + +\NEOTF{} does not aim at being as complete as \file{STIXTwoMath-Regular} or +\file{Cambria}, the current glyph coverage compares with TeXGyre math fonts. +In case some symbols do not show up in the output file, you will see warnings +in the \file{.log} file, for instance: + +\setmathfont{STIXTwoMath-Regular.otf}[range={"2964}] +\texttt{Missing character: There is no }$⥤$% +\texttt{ (U+2964) in font Euler Math} + +Borrowing them from a more complete font, say \file{Asana-Math}, +is a possible workaround: +\verb+\setmathfont{Asana-Math.otf}[range={"2964},Scale=1.02]+\\ +scaling is possible, multiple character ranges are separated with commas:\\ +\verb+\setmathfont{Asana-Math.otf}[range={"294A-"2951,"2964,"2ABB-"2ABE}]+ + +Let’s mention \pkg{albatross}, a useful tool to find out the list of fonts +providing a given glyph: f.i. type in a terminal ``\texttt{albatross U+2964}’’, +see the manpage or \file{albatross-manual.pdf}. + +\section{Acknowledgements} + +Khaled Hosni achieved most of the portage of Hermann Zapf’s Euler font to +Unicode between 2009 and 2016. After Hermann’s death in 2015, he decided to +stop the project but his \file{euler.otf} font, although not available on CTAN, +continued to be used, see +\href{https://tex.stackexchange.com/questions/425098/which-opentype-math-fonts-are-available}{https://tex.stackexchange.com/questions/425098/}. +I offered Khaled my help to finalise the font, we agreed I would try to +complete the font and maintain it on my own. + +\bigskip +\begin{center}\Huge +\decotwo +\end{center} + +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% TeX-engine: luatex +%%% TeX-master: t +%%% coding: utf-8 +%%% End: |