summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/greek-fontenc/textalpha.sty.html
blob: 49876aeabe70311ab99a271effa8d414ee212bb9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.12: http://docutils.sourceforge.net/" />
<title>textalpha: Greek symbols in text</title>
<meta name="copyright" content="© 2010 Günter Milde" />
<link rel="stylesheet" href="../../../../../Python/docutils-svn/docutils/docutils/writers/html4strict/html4css1.css" type="text/css" />
<link rel="stylesheet" href="../../../../../Python/docutils-svn/docutils/docutils/writers/html4strict/html4css2.css" type="text/css" />
</head>
<body>
<div class="document" id="textalpha-greek-symbols-in-text">
<h1 class="title">textalpha: Greek symbols in text</h1>

<dl class="docinfo">
<dt class="copyright">Copyright</dt>
<dd class="copyright">© 2010 Günter Milde</dd>
<dt>Licence</dt>
<dd><p>This work may be distributed and/or modified under the
conditions of the <a class="reference external" href="http://www.latex-project.org/lppl.txt">LaTeX Project Public License</a>, either
version&nbsp;1.3 of this license or any later version.</p>
</dd>
<dt>Identification</dt>
<dd><pre class="literal-block">\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{textalpha}
[2013/09/11 v0.5 macros for Greek letters in text]
</pre>
</dd>
</dl>
<div class="abstract topic">
<p class="topic-title first">Abstract</p>
<p>Provide a set of <tt class="literal">\text*</tt> macros for Greek letters
outside math.</p>
</div>
<div class="note">
<p class="admonition-title">Note</p>
<p>The package was renamed from <cite>textgreek</cite> to <cite>textalpha</cite> to prevent
confusion with the <a class="reference external" href="http://www.ctan.org/pkg/textgreek">textgreek</a> package by Leonard Michlmayr.</p>
</div>
<dl class="docutils">
<dt>Changelog:</dt>
<dd><table class="borderless">
<colgroup>
<col width="14%" />
<col width="7%" />
<col width="79%" />
</colgroup>
<tbody>
<tr><td><p>2010-06-16</p></td>
<td><p>0.1</p></td>
<td><p>initial version</p></td>
</tr>
<tr><td><p>2012-06-27</p></td>
<td><p>0.2</p></td>
<td><p>support for compound Unicode definitions outside LGR</p></td>
</tr>
<tr><td><p>2013-05-03</p></td>
<td><p>0.3</p></td>
<td><p>new accent macro names with <tt class="literal">lgrxenc.def</tt> 0.7</p></td>
</tr>
<tr><td><p>2013-05-28</p></td>
<td><p>0.4</p></td>
<td><p>use <tt class="literal">lgrenc.def</tt> from greek-fontenc.</p></td>
</tr>
<tr><td><p>2013-09-11</p></td>
<td><p>0.5</p></td>
<td><p>move to <a class="reference external" href="http://www.ctan.org/pkg/greek-fontenc">greek-fontenc</a>,</p></td>
</tr>
<tr><td><!--  -->
</td>
<td>&nbsp;</td>
<td><p>support XeTeX/LuaTeX, add breve below accents.</p></td>
</tr>
</tbody>
</table>
</dd>
</dl>
<div class="section" id="motivation">
<h1>Motivation</h1>
<p>By default, TeX macros for Greek letters are only valid in mathematical
mode. This package sets up a suitable font encoding and Greek LICR
definitions (<tt class="literal">\textalpha</tt> – <tt class="literal">\textOmega</tt>).</p>
<p>To allow documents using Greek LICR macros without worrying about the TeX
engine used to compile them, this package does a simple test (based on the
<tt class="literal">\ifdefined</tt> command provided by the <a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=etex">e-TeX</a> extension) and does “the right
thing” to set up Greek text font support for the detected engine.</p>
<p>For 8-bit TeX, this package also declares the LGR font encoding as default
for Greek LICR macros (cf. <a class="reference external" href="http://www.ctan.org/tex-archive/macros/latex/doc/fntguide.pdf">fntguide</a> section 5.3):</p>
<ul class="simple">
<li><p>Symbols from a Greek text font (e.g. the <a class="reference external" href="http://www.ctan.org/pkg/cbgreek-complete">CB fonts</a>) can be accessed
without the need for an explicite font-encoding switch.</p></li>
<li><p>In combination with <tt class="literal"><span class="pre">\usepackage[utf8]{inputenc}</span></tt> and <tt class="literal">lgrenc.dfu</tt>
from <a class="reference external" href="http://www.ctan.org/pkg/greek-inputenc">greek-inputenc</a>, Unicode input of Greek characters is supported in
any font encoding.</p></li>
</ul>
<div class="attention">
<p class="admonition-title">Attention!</p>
<p>The macros work well in any font encoding for single symbols.
However, with 8-bit TeX, the automatic font-encoding switches behind the
doors interfere with kerning between letters and replacement of
accent+character with a pre-composed character.</p>
<p>Therefore, Greek text should be written with the help of <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a> or
<a class="reference external" href="http://www.ctan.org/pkg/polyglossia">polyglossia</a> (setting the language to <tt class="literal">greek</tt>) or wrapped in the
provided <tt class="literal">ensuregreek</tt> macro.  Using <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a> or <a class="reference external" href="http://www.ctan.org/pkg/polyglossia">polyglossia</a> also helps
to ensure proper hyphenation.</p>
</div>
</div>
<div class="section" id="usage">
<h1>Usage</h1>
<pre class="code latex literal-block"><span class="keyword">\usepackage</span><span class="name builtin">{</span>textalpha<span class="name builtin">}</span>
</pre>
<p>For details see <a class="reference external" href="textalpha-test.tex">textalpha-test.tex</a> and <a class="reference external" href="textalpha-test.pdf">textalpha-test.pdf</a> (8-bit
TeX) as well as <a class="reference external" href="test-euenc.tex">test-euenc.tex</a> and <a class="reference external" href="test-euenc.pdf">test-euenc.pdf</a> (XeTeX/LuaTeX).</p>
</div>
<div class="section" id="implementation">
<h1>Implementation</h1>
<div class="section" id="requirements">
<h2>Requirements</h2>
<p>With XeTeX or LuaTeX, there is one common input and font encoding –
Unicode. 8-bit TeX&nbsp;font&nbsp;encodings should generally not be used. For
compatibility with the LaTeX font selection system, the package <a class="reference external" href="http://www.ctan.org/pkg/euenc">euenc</a>
defines the (pseudo) font encodings EU1 and EU2 for XeTeX and LuaTeX
respectively. However euenc does not (yet) define LICR macros. We therefore
explicitely load Greek LICR definitions for XeTeX/LuaTeX from <a class="reference external" href="http://www.ctan.org/pkg/greek-fontenc">greek-fontenc</a>.</p>
<div class="section" id="xetex">
<h3>XeTeX</h3>
<p>Use the EU1 font encoding. This is the only font encoding used with XeTeX,
so loading it with <a class="reference external" href="http://www.ctan.org/pkg/fontenc">fontenc</a> cannot mix up the default font encoding:</p>
<pre class="literal-block">\ifdefined\XeTeXrevision
  \usepackage[EU1]{fontenc}
</pre>
<p>Load the Greek LICR definitions for XeTeX/LuaTeX. In an ideal world, this
should be done in the eu1enc.def file of the <a class="reference external" href="http://www.ctan.org/pkg/euenc">euenc</a> package.</p>
<p>Before that, we must ensure EU1 is the <tt class="literal">\LastDeclaredEncoding</tt>: Beacause
fontenc loads font encoding definition files only once, it may happen that
another font encoding is defined after EU1 — for example <a class="reference external" href="http://www.ctan.org/pkg/fontspec">fontspec</a>
declares EU1 but leaves <tt class="literal">\LastDeclaredEncoding</tt> at <tt class="literal">T3</tt> (tipa), because
it later inputs the <a class="reference external" href="http://www.ctan.org/pkg/xunicode">xunicode</a> package which in turn loads <tt class="literal">t3enc.def</tt>.</p>
<pre class="literal-block">\renewcommand{\LastDeclaredEncoding}{EU1}
\input{greek-euenc.def}
</pre>
<p>No other action is required with Unicode-aware TeX engines:</p>
<pre class="literal-block">  \expandafter\endinput % &quot;return&quot;
\fi
</pre>
</div>
<div class="section" id="luatex">
<h3>LuaTeX</h3>
<p>Similar actions to XeTeX, but use the font encoding EU2:<a class="footnote-reference" href="#eu" id="id1"><sup>1</sup></a></p>
<pre class="literal-block">\ifdefined\luatexversion
  \usepackage[EU2]{fontenc}
  \renewcommand{\LastDeclaredEncoding}{EU2}
  \input{greek-euenc.def}
  \expandafter\endinput % &quot;return&quot;
\fi
</pre>
<dl class="footnote"><dt class="label"><a class="fn-backref" href="#id1">1</a></dt>
<dd id="eu">
<p class="first last">The two different (pseudo) font encodings allow different font setups for
XeTeX vs. LuaTeX using differently named <tt class="literal">*.fd</tt> files (see <a class="reference external" href="http://www.ctan.org/pkg/euenc">euenc</a> for
details).</p>
</dd>
</dl>
</div>
<div class="section" id="bit-tex">
<h3>8-bit TeX</h3>
<p>With 8-bit TeX, you usually pass the font encoding name(s) as option to
<a class="reference external" href="http://www.ctan.org/pkg/fontenc">fontenc</a> which then loads the corresponding <tt class="literal">*.def</tt> file(s). The last
option indicates the document’s default font encoding. (See <a class="citation-reference" href="#" id="id2">[fntguide]</a> for
details and <a class="reference external" href="lgrenc-test.tex">lgrenc-test.tex</a> for an example.) Therefore, we do not know
the documents main font encoding and hence cannot use
<tt class="literal"><span class="pre">\usepackage[LGR]{inputenc}</span></tt>. We load <tt class="literal">lgrenc.def</tt> directly, if it is
not already done and re-set <tt class="literal">\LastDeclaredEncoding</tt> else.</p>
<div class="note">
<p class="admonition-title">Note</p>
<p>The use of <tt class="literal">\&#64;ifundefined</tt> has the side-effect that the tested
macro becomes defined and set to <tt class="literal">\relax</tt> (polluting the namespace and
interfering with tests via eTeX’s <tt class="literal">\ifdefined</tt>). However, in this case
no harm is done as the macro is defined by <tt class="literal">lgrenc.def</tt> anyway.</p>
</div>
<pre class="literal-block">\&#64;ifundefined{ver&#64;lgrenc.def}
  {\input{lgrenc.def}}
  {\renewcommand{\LastDeclaredEncoding}{EU1}}
</pre>
</div>
</div>
<div class="section" id="default-declarations">
<h2>Default declarations</h2>
<p>The following definitions ensure that the Greek LICR macros can be used
anywhere in the document also with 8-bit TeX by declaring LGR as their
default font encoding.</p>
<div class="section" id="ensuregreek">
<h3>ensuregreek</h3>
<p>The <tt class="literal">\ensuregreek</tt> command can be used to ensure that its argument is set in
a font encoding with support for Greek. We define LGR as default encoding for
Greek text:</p>
<pre class="literal-block">\DeclareTextCommandDefault{\ensuregreek}[1]{{\fontencoding{LGR}\selectfont #1}}
</pre>
<!-- The [fntguide_] writes

  Note that ``\DeclareTextAccentDefault`` can be used on any
  one-argument encoding-specific command, not just those defined with
  ``\DeclareTextAccent``.

However, the simpler alternative
``\DeclareTextAccentDefault{\ensuregreek}{LGR}`` fails with the table of
Unicode characters in the test document `<textalpha-test.tex>`__:

  ``! You can't use a prefix with `end-group character }'.`` -->
<p>Eventually, all font encodings supporting Greek script (e.g. LGI, PU, EU1,
EU2) will declare <tt class="literal">\ensuregreek</tt> as text command that passes the argument
unchanged. This way, kerning and selection of precomposed glyphs would work
also for cases like <tt class="literal"><span class="pre">\ensuregreek{\'A}U</span></tt>.</p>
<!-- Do this for PU here? ``\DeclareTextCommand{\ensuregreek}{PU}[1]{#1}``

Can lead to infinite recursion (``TeX capacity exeeded``) without the
``unicode=true`` hyperref option.
(How about a test whether the PU font encoding is defined?). -->
</div>
<div class="section" id="greek-alphabet">
<h3>Greek Alphabet</h3>
<p>Define the <tt class="literal">text*</tt> marcos as default for all font encodings:</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textAlpha}{LGR}
\DeclareTextSymbolDefault{\textBeta}{LGR}
\DeclareTextSymbolDefault{\textGamma}{LGR}
\DeclareTextSymbolDefault{\textDelta}{LGR}
\DeclareTextSymbolDefault{\textEpsilon}{LGR}
\DeclareTextSymbolDefault{\textZeta}{LGR}
\DeclareTextSymbolDefault{\textEta}{LGR}
\DeclareTextSymbolDefault{\textTheta}{LGR}
\DeclareTextSymbolDefault{\textIota}{LGR}
\DeclareTextSymbolDefault{\textKappa}{LGR}
\DeclareTextSymbolDefault{\textLambda}{LGR}
\DeclareTextSymbolDefault{\textMu}{LGR}
\DeclareTextSymbolDefault{\textNu}{LGR}
\DeclareTextSymbolDefault{\textXi}{LGR}
\DeclareTextSymbolDefault{\textOmicron}{LGR}
\DeclareTextSymbolDefault{\textPi}{LGR}
\DeclareTextSymbolDefault{\textRho}{LGR}
\DeclareTextSymbolDefault{\textSigma}{LGR}
\DeclareTextSymbolDefault{\textTau}{LGR}
\DeclareTextSymbolDefault{\textUpsilon}{LGR}
\DeclareTextSymbolDefault{\textPhi}{LGR}
\DeclareTextSymbolDefault{\textChi}{LGR}
\DeclareTextSymbolDefault{\textPsi}{LGR}
\DeclareTextSymbolDefault{\textOmega}{LGR}
%
\DeclareTextSymbolDefault{\textalpha}{LGR}
\DeclareTextSymbolDefault{\textbeta}{LGR}
\DeclareTextSymbolDefault{\textgamma}{LGR}
\DeclareTextSymbolDefault{\textdelta}{LGR}
\DeclareTextSymbolDefault{\textepsilon}{LGR}
\DeclareTextSymbolDefault{\textzeta}{LGR}
\DeclareTextSymbolDefault{\texteta}{LGR}
\DeclareTextSymbolDefault{\texttheta}{LGR}
\DeclareTextSymbolDefault{\textiota}{LGR}
\DeclareTextSymbolDefault{\textkappa}{LGR}
\DeclareTextSymbolDefault{\textlambda}{LGR}
\DeclareTextSymbolDefault{\textmu}{LGR}
\DeclareTextSymbolDefault{\textnu}{LGR}
\DeclareTextSymbolDefault{\textxi}{LGR}
\DeclareTextSymbolDefault{\textomicron}{LGR}
\DeclareTextSymbolDefault{\textpi}{LGR}
\DeclareTextSymbolDefault{\textrho}{LGR}
\DeclareTextSymbolDefault{\textsigma}{LGR}
\DeclareTextSymbolDefault{\textvarsigma}{LGR}
\DeclareTextSymbolDefault{\textfinalsigma}{LGR} % alias for \textvarsigma
\DeclareTextSymbolDefault{\textautosigma}{LGR}  % char 115 in LGR
\DeclareTextSymbolDefault{\texttau}{LGR}
\DeclareTextSymbolDefault{\textupsilon}{LGR}
\DeclareTextSymbolDefault{\textphi}{LGR}
\DeclareTextSymbolDefault{\textchi}{LGR}
\DeclareTextSymbolDefault{\textpsi}{LGR}
\DeclareTextSymbolDefault{\textomega}{LGR}
</pre>
<div class="section" id="additional-greek-symbols">
<h4>Additional Greek symbols</h4>
<p>Including alias names for compatibility with hyperref’s puenc.def.</p>
<p>Ancient Greek Numbers (Athenian Numerals):</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textpentedeka}{LGR}    % GREEK ACROPHONIC ATTIC FIFTY
\DeclareTextSymbolDefault{\textpentehekaton}{LGR} % GREEK ACROPHONIC ATTIC FIVE HUNDRED
\DeclareTextSymbolDefault{\textpenteqilioi}{LGR}  % GREEK ACROPHONIC ATTIC FIVE THOUSAND
\DeclareTextSymbolDefault{\textpentemurioi}{LGR}  % GREEK ACROPHONIC ATTIC FIFTY THOUSAND
</pre>
<p>Archaic letters:</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textstigma}{LGR}      % ϛ
\DeclareTextSymbolDefault{\textstigmagreek}{LGR} % ϛ (puenc.def)
\DeclareTextSymbolDefault{\textvarstigma}{LGR}   % stigma variant
\DeclareTextSymbolDefault{\textkoppa}{LGR}       % ϟ (greek small letter koppa)
\DeclareTextSymbolDefault{\textkoppagreek}{LGR}  % ϟ (puenc.def)
\DeclareTextSymbolDefault{\textqoppa}{LGR}       % ϙ (archaic koppa)
\DeclareTextSymbolDefault{\textQoppa}{LGR}       % Ϙ (archaic Koppa)
\DeclareTextSymbolDefault{\textStigma}{LGR}      % Ϛ ϹΤ ligature in some fonts
\DeclareTextSymbolDefault{\textStigmagreek}{LGR} % Ϛ (puenc.def)
\DeclareTextSymbolDefault{\textSampi}{LGR}       % Ϡ
\DeclareTextSymbolDefault{\textSampigreek}{LGR}  % Ϡ (puenc.def)
\DeclareTextSymbolDefault{\textsampi}{LGR}       % ϡ
\DeclareTextSymbolDefault{\textsampigreek}{LGR}  % ϡ (puenc.def)
\DeclareTextSymbolDefault{\textanoteleia}{LGR}   % ·
\DeclareTextSymbolDefault{\texterotimatiko}{LGR} % ; (003B is the preferred character)
\DeclareTextSymbolDefault{\textdigamma}{LGR}     % ϝ
\DeclareTextSymbolDefault{\textDigamma}{LGR}     % Ϝ
\DeclareTextSymbolDefault{\textdigammagreek}{LGR} % ϝ (puenc.def)
\DeclareTextSymbolDefault{\textDigammagreek}{LGR} % Ϝ (puenc.def)
</pre>
<p>numeral signs: <a class="reference external" href="http://en.wikipedia.org/wiki/Greek_numerals">http://en.wikipedia.org/wiki/Greek_numerals</a></p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textnumeralsigngreek}{LGR}      % (puenc.def)
\DeclareTextSymbolDefault{\textnumeralsignlowergreek}{LGR} % (puenc.def)
</pre>
</div>
</div>
<div class="section" id="diacritics">
<h3>Diacritics</h3>
<p>Greek diacritics via “named” macros:</p>
<pre class="literal-block">\DeclareTextAccentDefault{\accdasia}{LGR}
\DeclareTextAccentDefault{\accpsili}{LGR}
\DeclareTextAccentDefault{\acctonos}{LGR}
\DeclareTextAccentDefault{\accvaria}{LGR}
\DeclareTextAccentDefault{\accperispomeni}{LGR}
\DeclareTextAccentDefault{\accdialytika}{LGR}
\DeclareTextAccentDefault{\&lt;}{LGR}
\DeclareTextAccentDefault{\&gt;}{LGR}
%
\DeclareTextAccentDefault{\accdasiaoxia}{LGR}
\DeclareTextAccentDefault{\accdasiavaria}{LGR}
\DeclareTextAccentDefault{\accdasiaperispomeni}{LGR}
\DeclareTextAccentDefault{\accpsilioxia}{LGR}
\DeclareTextAccentDefault{\accpsilivaria}{LGR}
\DeclareTextAccentDefault{\accpsiliperispomeni}{LGR}
\DeclareTextAccentDefault{\accdialytikatonos}{LGR}
\DeclareTextAccentDefault{\accdialytikavaria}{LGR}
\DeclareTextAccentDefault{\accdialytikaperispomeni}{LGR}
</pre>
<p>Postfix accents:</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\ypogegrammeni}{LGR} % &quot;small&quot; sub-iota
\DeclareTextSymbolDefault{\prosgegrammeni}{LGR}  % &quot;capital&quot; sub-iota
</pre>
<p>Other accents in LGR:</p>
<pre class="literal-block">\DeclareTextAccentDefault{\accinvertedbrevebelow}{LGR} % INVERTED BREVE BELOW
\DeclareTextAccentDefault{\textsubarch}{LGR}           % tipa, Teubner name: ut
\DeclareTextAccentDefault{\accbrevebelow}{LGR}         % BREVE BELOW
</pre>
</div>
<div class="section" id="auxiliary-macros">
<h3>Auxiliary macros</h3>
<p><tt class="literal">\MakeUppercase</tt> requires two internal commands:</p>
<pre class="literal-block">\DeclareTextAccentDefault{\LGR&#64;hiatus}{LGR}
\DeclareTextAccentDefault{\LGR&#64;Dialytika}{LGR}
</pre>
<!-- References
- - - - - - - - - - -->
</div>
</div>
</div>
</div>
</body>
</html>