summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-09-05 22:00:16 +0000
committerKarl Berry <karl@freefriends.org>2015-09-05 22:00:16 +0000
commit62cb48658056cee12fac2741b88adac4d664851e (patch)
treea06a15d042d5db480314b5a436d63ca3e02a2c0e /Master/texmf-dist/doc/latex/greek-fontenc/alphabeta-doc.tex
parentb87d035e26c6d72bc073ee6a6cf5459e444afbd2 (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.tex170
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}