diff options
Diffstat (limited to 'language/greek/greek-fontenc/textalpha-doc.tex')
-rw-r--r-- | language/greek/greek-fontenc/textalpha-doc.tex | 146 |
1 files changed, 96 insertions, 50 deletions
diff --git a/language/greek/greek-fontenc/textalpha-doc.tex b/language/greek/greek-fontenc/textalpha-doc.tex index 099bbc94cd..00163fdc15 100644 --- a/language/greek/greek-fontenc/textalpha-doc.tex +++ b/language/greek/greek-fontenc/textalpha-doc.tex @@ -7,17 +7,18 @@ \usepackage[LGR,T1]{fontenc} % UTF8 input encoding for pdfTeX or LuaTeX in 8-bit compatibility mode: -% (XeTeX in compatibility mode would require xetex-inputenc.sty, which is not -% at CTAN but on https://github.com/wspr/xetex-inputenc) +% (XeTeX in compatibility mode would require xetex-inputenc.sty, which is +% not at CTAN but on https://github.com/wspr/xetex-inputenc) \usepackage[utf8]{luainputenc} -\usepackage[pdfencoding=auto,colorlinks=true]{hyperref} +\usepackage[pdfencoding=auto,colorlinks=true,linkcolor=blue]{hyperref} \usepackage{bookmark} % hyperrefs PU encoding supports Greek LICR macros \DeclareTextCommand{\ensuregreek}{PU}[1]{#1} -\usepackage[normalize-symbols] % comment option out to test error reporting - {textalpha} +\usepackage[normalize-symbols, % comment option out to test error reporting + keep-semicolon% + ]{textalpha} \begin{document} @@ -25,20 +26,14 @@ \author{Günter Milde} \maketitle -Standard 8-bit TeX fonts do not support the Greek script. If Greek -characters shall be used with 8-bit TeX, setup of a Greek text font and an -explcit font-encoding switch is required. - -With the \emph{textalpha} package, you can easily write a single Greek -symbol (like \textPsi{} or \textmu{}) or a -\textlambda\textomicron\textgamma\textomicron\textvarsigma{} in non-Greek -text as well as ISO-conforming formulas with upright constants (like -\textpi): $A = \mbox{\textpi} r^2$ vs. $A = \pi r^2$. Input is possible via -LICR macros (\verb|\textalpha| \ldots \verb|\textOmega|) -or Unicode literals\footnote{% +\abstract{\noindent +The \emph{textalpha} package enables the use of Greek characters +in text independent of font encoding or TeX engine. Input is possible via +text commands (\verb|\textalpha| \ldots +\verb|\textOmega|) or Unicode literals\footnote{% Requires \emph{\href{http://www.ctan.org/pkg/greek-inputenc}{greek-inputenc}} -and the utf8 option or XeTeX/LuaTeX.}. - +or XeTeX/LuaTeX.}. +} \tableofcontents \section{Usage} @@ -47,48 +42,48 @@ Load this package in the preamble of your document with \begin{verbatim} \usepackage{textalpha} \end{verbatim} -If it is loaded after the setup of Unicode fonts with +eventually with options \texttt{normalize-symbols} and/or +\texttt{keep-semicolon}. + +If \emph{textalpha} is loaded after the setup of Unicode fonts with the \href{http://www.ctan.org/pkg/fontspec}{\emph{fontspec}} package under LuaTeX and XeTeX, it provides a compatible interface for Greek in text mode. -If you want to merge symbol variants, use the -\texttt{normalize-symbols} option:% -\footnote{This option is ignored with Unicode fonts.} -\begin{verbatim} - \usepackage[normalize-symbols]{textalpha} -\end{verbatim} See the source of this document \url{textalpha-doc.tex} for a setup and usage example, the literate source of the package \href{textalpha.sty.html}{textalpha.sty} for the implementation, and -\emph{Font setup for Greek with XeTeX/LuaTeX} -(\href{euenc-doc.pdf}{euenc-doc.pdf}) for special feature under XeTeX/LuaTeX. +\href{tuenc-greek-doc.pdf}{tuenc-greek-doc.pdf} for +\emph{Font setup for Greek with XeTeX/LuaTeX}. \subsection{option \texttt{normalize-symbols}} -This option is ignored with Unicode fonts. - Mathematical notation uses variant shapes of some Greek letters as additional symbols. There are separate code points for the symbol variants -in Unicode but not in the LGR font encoding used for Greek in 8-bit TeX. -TeX supports some of the variant shape symbols in mathematical mode -($\theta|\vartheta, \phi|\varphi, \pi|\varpi, \rho|\varrho, -\epsilon|\varepsilon$). +in Unicode. TeX supports some of the variant shape symbols in mathematical +mode ($\theta|\vartheta, \phi|\varphi, \pi|\varpi, \rho|\varrho, +\epsilon|\varepsilon$) but not in the LGR font encoding used for Greek in +8-bit TeX. 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. -However, some Greek texts in Unicode encoding use these GREEK -... SYMBOL characters in place of the corresponding GREEK LETTER ... -characters. +However, some Greek texts use these GREEK ... SYMBOL characters in place of +the corresponding GREEK LETTER ... characters. The \texttt{normalize-symbols} option merges letters and symbols to Greek -letters. This way, text copied from external sources can be compiled without +letters. +This way, text copied from external sources can be compiled without errors even if it contains GREEK SYMBOL characters in place of GREEK LETTERS: \begin{quote} This text uses both variants for beta (β|ϐ), theta (θ|ϑ), phi (φ|ϕ), pi (π|ϖ), kappa (κ|ϰ), rho (ρ|ϱ), Theta (Θ|ϴ), and epsilon (ε|ϵ) in the LaTeX source. + + \greekscript + This text uses both variants for beta (β|ϐ), theta (θ|ϑ), phi (φ|ϕ), pi + (π|ϖ), kappa (κ|ϰ), rho (ρ|ϱ), Theta (Θ|ϴ), and epsilon (ε|ϵ) in the LaTeX + source. \end{quote} \textbf{Attention}: Do not use this option in cases where the distinction @@ -97,7 +92,51 @@ scientific context). Try the \emph{alphabeta} package with the respective characters in math mode or use XeTeX/LuaTeX with Unicode fonts in these cases. -\section{Limitations} +This option is ignored with Unicode fonts. + +\subsection{\texttt{keep-semicolon}} + +LGR is no ``standard font encoding''. Latin characters and some other ASCII +symbols are mapped to Greek ``equivalents'' if LGR is the active font +encoding. (See +\href{http://mirrors.ctan.org/language/babel/contrib/greek/usage.pdf}{usage.pdf} +for a description of this Latin-Greek transliteration.) + +Special care is required with the question mark characters: The LGR font +encoding uses the Latin question mark as input for the \emph{erotimatiko} +and maps the semicolon to a middle dot (\emph{ano teleia}). +As a result, Unicode-encoded texts that use the semicolon as +\emph{erotimatiko} end up with an \emph{ano teleia} in its place! +Without special care, only the deprecated character 037E GREEK QUESTION MARK% +\footnote{The Unicode standard provides the code point 037E GREEK QUESTION MARK + but says character 003B SEMICOLON and not 037E is the preferred + character for a `Greek question mark' (erotimatiko).} +works with both, Xe/LuaTeX and 8-bit TeX. + +The \verb|\textsemicolon| command inserts an \emph{erotimatiko} in LGR and a +semicolon else (i.e. always a character that looks like a semicolon): +\begin{quote} + Latin (T1) a\textsemicolon{} b, + Greek (LGR) \ensuregreek{a\textsemicolon{} b} +\end{quote} + +With the \texttt{keep-semicolon} option, character 003B SEMICOLON can be used +for the \emph{erotimatiko} also with LGR encoded fonts: + +\begin{center} +\begin{tabular}{lll} + Latin (T1) & Greek (LGR) & question mark character \\ + \midrule + Τί φήις; & \ensuregreek{Τί φήις;} & 037E GREEK QUESTION MARK \\ + Τί φήις; & \ensuregreek{Τί φήις;} & 003B SEMICOLON \\ + Τί φήις? & \ensuregreek{Τί φήις?} & 003F QUESTION MARK \\ +\end{tabular} +\end{center} + +This option is ignored with Unicode fonts. + + +\section{Limitations \label{sec:limitations}} Because the internal font encoding switch interferes with other work behind the scenes, kerning, diacritics and up/down-casing show problems if Greek @@ -110,7 +149,7 @@ wrapping the Greek text in \verb|\ensuregreek|% is set in a font encoding supporting Greek. % This can be used to fix these % problems without adverse side-effects if the active font encoding is - % already LGR or Unicode. + % already LGR or TU. }, or XeTeX/LuaTeX with Unicode fonts. @@ -149,17 +188,20 @@ UPPERCASE: } \end{quote} % -This fails for accent macros if the active font encoding is not LGR or -Unicode. Pre-composed literal Unicode characters are handled correctly: +This fails for accent macros if the active font encoding does not support +Greek. Pre-composed literal Unicode characters are handled correctly: \begin{quote} - \ensuregreek{\'\textAlpha/Ά} (LICR/Unicode in LGR) vs. - \'\textAlpha/Ά (LICR/Unicode in T1). + \begin{tabular}{ccc} + & LICR & Unicode \\ \hline + LGR & \ensuregreek{\'\textAlpha} & \ensuregreek{Ά} \\ + T1 & \'\textAlpha & Ά \\ + \end{tabular} \end{quote} The dialytika marks a \emph{hiatus} (break-up of a diphthong). It must be present in UPPERCASE even where it is redundant in lowercase (the hiatus can also be marked by an accent on the first character of a diphthong). The -auto-hiatus feature works in LGR and Unicode font encodings only: +auto-hiatus feature works in LGR and TU font encodings only: \begin{quote} \acctonos\textalpha\textupsilon{}, \acctonos\textepsilon\textiota{} $\mapsto$ \MakeUppercase{\ensuregreek{ @@ -185,7 +227,7 @@ internal font encoding switch: compare \ensuregreek{\textAlpha\textUpsilon\textAlpha} (LGR) to \textAlpha\textUpsilon\textAlpha (T1). -Compiling with LuaTeX provides kerning also over font encoding boundaries. +Compiling with LuaTeX provides kerning also on font encoding boundaries. \section{Test and Examples} @@ -198,6 +240,7 @@ Greek letters via Latin transcription in LGR font encoding: \ensuregreek{a b g d e z h j i k l m n x o p r sv c t u f q y w} \end{quote} +\smallskip\noindent Greek letters via default macros in other font encoding (here T1): \begin{quote} @@ -214,6 +257,7 @@ Greek letters via default macros in other font encoding (here T1): \textphi{} \textchi{} \textpsi{} \textomega{} \end{quote} +\smallskip\noindent Archaic Greek letters and Greek punctuation \begin{quote} @@ -234,6 +278,7 @@ Archaic Greek letters and Greek punctuation \textvarstigma \end{quote} +\smallskip\noindent Diacritics \begin{quote} @@ -269,6 +314,7 @@ Diacritics \end{quote} +\medskip\noindent Accent macros can start with \verb|\a| instead of \verb|\| when the short form is redefined, e.\,g. inside a \emph{tabbing} environment. This also works for the new-defined Dasia and Psili shortcuts: @@ -299,20 +345,20 @@ Kerning is preserved if the font encoding is LGR: \ensuregreek{AΫA} \toprule & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9 & A & B & C & D & E & F\\ \midrule -370 & * & * & * & * & ʹ & ͵ & * & * & & & ͺ & * & * & * & ; & \\ +370 & ◦ & ◦ & ◦ & ◦ & ʹ & ͵ & ◦ & ◦ & & & ͺ & ◦ & ◦ & ◦ & ; & \\ 380 & & & & & ΄ & ΅ & Ά & · & Έ & Ή & Ί & & Ό & & Ύ & Ώ\\ 390 & ΐ & Α & Β & Γ & Δ & Ε & Ζ & Η & Θ & Ι & Κ & Λ & Μ & Ν & Ξ & Ο\\ 3A0 & Π & Ρ & & Σ & Τ & Υ & Φ & Χ & Ψ & Ω & Ϊ & Ϋ & ά & έ & ή & ί\\ 3B0 & ΰ & α & β & γ & δ & ε & ζ & η & θ & ι & κ & λ & μ & ν & ξ & ο\\ 3C0 & π & ρ & ς & σ & τ & υ & φ & χ & ψ & ω & ϊ & ϋ & ό & ύ & ώ & \\ -3D0 & * & * & * & * & * & * & * & * & Ϙ & ϙ & Ϛ & ϛ & Ϝ & ϝ & * & ϟ\\ -3E0 & Ϡ & ϡ & * & * & * & * & * & * & * & * & * & * & * & * & * & *\\ -3F0 & * & * & * & * & * & * & * & * & * & * & * & * & * & * & * & *\\ +3D0 & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & Ϙ & ϙ & Ϛ & ϛ & Ϝ & ϝ & ◦ & ϟ\\ +3E0 & Ϡ & ϡ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦\\ +3F0 & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦ & ◦\\ \bottomrule \end{tabular} } % end centerline \caption{Greek and Coptic Unicode Block, input as literal Unicode - characters in T1 font encoding (legend: * glyph missing in LGR).} + characters in T1 font encoding (legend: ◦ glyph missing in LGR).} \label{tab:greek-and-coptic} \end{table} |