diff options
author | Karl Berry <karl@freefriends.org> | 2015-09-05 22:00:16 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-09-05 22:00:16 +0000 |
commit | 62cb48658056cee12fac2741b88adac4d664851e (patch) | |
tree | a06a15d042d5db480314b5a436d63ca3e02a2c0e /Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex | |
parent | b87d035e26c6d72bc073ee6a6cf5459e444afbd2 (diff) |
greek-fontenc (4sep15)
git-svn-id: svn://tug.org/texlive/trunk@38297 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex | 170 |
1 files changed, 141 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex b/Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex index 0dc26a63bfc..d110bb65552 100644 --- a/Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex +++ b/Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex @@ -9,38 +9,49 @@ \ifdefined\XeTeXrevision \usepackage[no-math]{fontspec} \setmainfont{Linux Libertine O} + \setsansfont{Linux Biolinum O} + \setmonofont{Inconsolata}[Scale=MatchLowercase] \usepackage[libertine,slantedGreek]{newtxmath} - \providecommand*{\varstigma}{$\oslash$} + % \usepackage{unicode-math} \else\ifdefined\luatexversion \usepackage{fontspec} \setmainfont{Linux Libertine O} + \setsansfont{Linux Biolinum O} + \setmonofont{Inconsolata}[Scale=MatchLowercase] \usepackage[libertine,slantedGreek]{newtxmath} - \providecommand*{\varstigma}{$\oslash$} \else \usepackage[utf8]{inputenc} \usepackage[LGR,T1]{fontenc} \usepackage{textcomp} - % \usepackage{lmodern} + \usepackage{lmodern} + % \usepackage{libertine} % \usepackage{gfsdidot} % \usepackage{kerkis} - \usepackage{newtxtext,newtxmath} - \usepackage{substitutefont} - \substitutefont{LGR}{\rmdefault}{artemisia} + % \usepackage{newtxtext,newtxmath} + % \usepackage{substitutefont} + % \substitutefont{LGR}{\rmdefault}{artemisia} \usepackage{isomath} \fi\fi % No section numbers but PDF bookmarks for sections -\setcounter{secnumdepth}{0} +% \setcounter{secnumdepth}{0} % load alphabeta after math setup and encoding setup! -\usepackage{alphabeta} +% \usepackage{alphabeta} +\usepackage[normalize-symbols]{alphabeta} % Avoid warnigns with PDF string generation for "alphabeta" commands: % let \TextOrMath (from fixltx2e) return the "text" argument: -\pdfstringdefDisableCommands{% - \let\TextOrMath\@firstoftwo% -} +\pdfstringdefDisableCommands{\let\TextOrMath\@firstoftwo} + +% varstigma only defined with 8-bit LGR fonts +\providecommand*{\varstigma}{$\oslash$} + +% varkappa, only defined with newtxmath, other var... only with unicode-math +\providecommand*{\varkappa}{\oslash} +\providecommand*{\varbeta}{\oslash} +\providecommand*{\varTheta}{\oslash} \begin{document} @@ -66,26 +77,50 @@ math mode (capital letters upright without \emph{fixmath} or This makes it easy to write a single Greek symbol (like \Psi{} or \mu{}) or a \lambda\omicron\gamma\omicron\varsigma{} in non-Greek text as well as ISO-conforming formulas with upright symbols for constants like $A = -\text{\pi} r^2$ instead of $A = \pi r^2$.\footnote{% +\text{\pi} r^2$ (instead of $A = \pi r^2$).\footnote{% The \emph{\href{http://www.ctan.org/pkg/isomath}{isomath}} package documentation describes more alternatives for upright Greek symbols in math mode.} -See the source of this document \url{alphabeta-doc.tex} for a setup and -usage example. +\section{Usage} -\section{Tests and examples} +Load this package in the preamble of your document (after font and math +setup) with +\begin{verbatim} + \usepackage{alphabeta} +\end{verbatim} +or, if you want to merge symbol variants, with the +\texttt{normalize-symbols} option: +\begin{verbatim} + \usepackage[normalize-symbols]{alphabeta} +\end{verbatim} -\subsection{Greek alphabet} +See the source of this document \url{alphabeta-doc.tex} for a setup and +usage example. -Greek letters via Latin transscription in LGR font encoding: +\subsection{option normalize-symbols} +The \texttt{normalize-symbols} option is passed to the +\href{alphabeta-doc.pdf}{\emph{alphabeta}} package. It +merges ``letters'' and ``symbol`` variants of some Greek +letters to the ``letter'' character (but is ignored with Unicode fonts): \begin{quote} - \ensuregreek{A B G D E Z H J I K L M N X O P R S T U F Q Y W}\\ - \ensuregreek{a b g d e z h j i k l m n x o p r s c t u f q y w} + This text uses both variants for beta (β|ϐ), theta (θ|ϑ), phi (φ|ϕ), pi + (π|ϖ), kappa (κ|ϰ), rho (ρ|ϱ), Theta (Θ|ϴ), and epsilon (ε|ϵ) in the LaTeX + source. \end{quote} -Greek letters via default macros without language/font-encoding switch: +\textbf{Attention}: Be careful in cases where the distinction between the +symbol variants may be important (e.g. in a mathematical or scientific +context). Use XeTeX/LuaTeX with Unicode fonts or the respective characters +in math mode (e.g. $π$ vs. $ϖ$). + +\section{Tests and examples} + +\subsection{Greek alphabet} + +Greek letters via generic ``name'' macros without language/font-encoding +switch: \begin{quote} \Alpha{} \Beta{} \Gamma{} \Delta{} \Epsilon{} \Zeta{} \Eta{} \Theta{} @@ -97,7 +132,7 @@ Greek letters via default macros without language/font-encoding switch: \sigma{} \varsigma{} \tau{} \upsilon{} \phi{} \chi{} \psi{} \omega{} \\ \digamma{} \Digamma{} \stigma{} \varstigma{}% - \footnote{\texttt{\textbackslash varstigma} is not defined with + \footnote{\texttt{\textbackslash varstigma} is not defined with Xe/LuaTeX and similar to \texttt{\textbackslash stigma} in some fonts.} \koppa{} \qoppa{} \Qoppa{} \Stigma{} \Sampi{} \sampi{} @@ -111,6 +146,77 @@ Greek letters via Unicode input without language/font-encoding switch: ϝ Ϝ ϛ ϟ ϙ Ϙ Ϛ Ϡ ϡ \end{quote} +\subsubsection{symbol variants} + +Mathematical notation uses variant shapes of some Greek letters as +additional symbols. The variations have no syntactic meaning in Greek text +and text fonts may use the variant shapes in place of the “regular” ones as +a stylistic choice. + +Unicode defines separate code points for the symbol variants. TeX supports +some of the variant shape symbols in mathematical mode, but its concept of +“standard” vs. “variant” symbols differs from the distinction between +“GREEK LETTER ...” vs. “GREEK ... SYMBOL” in the Unicode standard +See \href{greek-euenc-doc.pdf}{greek-euenc-doc}. + +The \emph{alphabeta} package defines generic macros for these variants that +are short forms of the set defined in \texttt{greek-euenc.def}: +\begin{quote} + \verb|\<name>| selects the Unicode GREEK LETTER ... variant, + + \verb|\<name>symbol| selects the Unicode + GREEK ... SYMBOL variant, + + \verb|\var<name>| selects the variant + shape according to TeX' mathematical mode +\end{quote} +See Table \ref{tab:symbol-variant-macros} for the full list. +\begin{table}[tbp] + \centering + \begin{tabular}{lcc} + \hline + macro & text & math \\ + \hline + \verb$\pi$ & \pi & $\pi$ \\ + \verb$\varpi$ & \varpi & $\varpi$ \\ + \verb$\pisymbol$ & \pisymbol & $\pisymbol$ \\ + \hline + \verb$\rho$ & \rho & $\rho$ \\ + \verb$\varrho$ & \varrho & $\varrho$ \\ + \verb$\rhosymbol$ & \rhosymbol & $\rhosymbol$ \\ + \hline + \verb$\theta$ & \theta & $\theta$ \\ + \verb$\vartheta$ & \vartheta & $\vartheta$ \\ + \verb$\thetasymbol$ & \thetasymbol & $\thetasymbol$ \\ + \hline + \verb$\epsilon$ & \epsilon & $\epsilon$ \\ + \verb$\varepsilon$ & \varepsilon & $\varepsilon$ \\ + \verb$\epsilonsymbol$ & \epsilonsymbol & $\epsilonsymbol$ \\ + \hline + \verb$\phi$ & \phi & $\phi$ \\ + \verb$\varphi$ & \varphi & $\varphi$ \\ + \verb$\phisymbol$ & \phisymbol & $\phisymbol$ \\ + \hline + \verb$\beta$ & \beta & $\beta$ \\ + \verb$\varbeta$ & \varbeta & $\varbeta$ \\ + \verb$\betasymbol$ & \betasymbol & $\betasymbol$ \\ + \hline + \verb$\kappa$ & \kappa & $\kappa$ \\ + \verb$\varkappa$ & \varkappa & $\varkappa$ \\ + \verb$\kappasymbol$ & \kappasymbol & $\kappasymbol$\\ + \hline + \verb$\Theta$ & \Theta & $\Theta$ \\ + \verb$\varTheta$ & & $\varTheta$ \\ + \verb$\Thetasymbol$ & \Thetasymbol & \\ + \hline + \end{tabular} + \caption{Macros for Greek symbol variants. With 8-bit TeX and the + \texttt{normalize-symbols} option, the output for both variants in text + mode is the same, as 8-bit Greek text fonts contain only one symbol + variant.} \label{tab:symbol-variant-macros} +\end{table} + + \subsection{\ensuregreek{% Ἑλληνικά (\<\Epsilon\lambda\lambda\eta\nu\iota\kappa\'\alpha{})} @@ -131,9 +237,7 @@ Warnings like \texttt{Token not allowed in a PDF string can be ignored or avoided with the preamble code: \begin{verbatim} -\pdfstringdefDisableCommands{% - \let\TextOrMath\@firstoftwo% -} + \pdfstringdefDisableCommands{\let\TextOrMath\@firstoftwo} \end{verbatim} @@ -150,7 +254,7 @@ mathematical mode (for XeTeX/LuaTeX use unicode-math): \[ Γ = \frac{\sin α}{\cos{β}}. \] -Greek letters in math (there are no math macros for Greek letters wich exist +Greek letters and symbols in math (there are no math macros for Greek letters wich exist with similar shape in the Latin alphabet): Input as macro: @@ -179,16 +283,22 @@ Input as macro: % \omicron{} \pi{} \rho{} \sigma{} \varsigma{} \tau{} \upsilon{} \phi{} \chi{} \psi{} \omega{} - \, \digamma{} +\\& + \vartheta \varphi \varpi \digamma{} \varrho \varepsilon \end{align*} Input as Unicode literals (with XeTeX/LuaTeX, this requires the unicode-math package): \begin{align*} & Γ ΔΘΛΞΠΣΥ ΦΨ Ω \\ - & αβγδεζηθικλμνξπρσςτ υφχψω \, ϝ + & αβγδεζηθικλμνξπρσςτυφχψω \\ + & ϑϕϖϝϱϵ \end{align*} +The "normal" vs. "variant" shape of phi and epsilon is inverted when using +traditional makros or Unicode letter vs. symbol characters respectively. +This is to keep backwards compatibility of the math macros as well +as consistent input-output mapping for Unicode in text and math. PDF strings do not know math mode. The content of a formula or equation is evaluated in text mode with non-valid commands discarded (and warnings @@ -205,6 +315,7 @@ Accent macros are set up for use with the generic macros by definition of Diacritics (except the dialytika) should placed before capital letters and dropped with MakeUppercase: +\begin{quote} \ensuregreek{ \<{\alpha} \>{\epsilon} \"'{\iota} \>`{\eta} \'<{\omicron} \~<{\upsilon} \~>{\omega} @@ -216,6 +327,7 @@ before capital letters and dropped with MakeUppercase: \<{\alpha} \>{\epsilon} \"'{\iota} \>`\eta{} \'<{\omicron} \~<{\upsilon} \~>{\omega} }} +\end{quote} \subsection{Limitations} @@ -252,8 +364,8 @@ encoding is not LGR: The \verb+\ensuregreek+ macro ensures that the argument is typeset with a font encoding supporting Greek. This keeps kerning (if the kerning pair is -inside the argument, \ensuregreek{\Alpha\Upsilon\Alpha}), and allows -iterative accent macros where pre-composed characters are selected +inside the argument, \ensuregreek{\Alpha\"\Upsilon\Alpha}), and allows +combining of accent macros where pre-composed characters are selected (\ensuregreek{\<'\alpha}). \end{document} |