summaryrefslogtreecommitdiff
path: root/language/greek/greek-fontenc/greek-fontenc-doc.rst
blob: fb6a647652eb2ca20e7486bfc33c186cd70ea733 (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
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
*************
greek-fontenc
*************
Greek font encoding definition files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

:Version: 2.3 (changelog_)

:Copyright: © 2010 -- 2023 Günter Milde <milde@users.sf.net>
:Licence:   This work may be distributed and/or modified under the
            conditions of the `LaTeX Project Public License`_, either
            version 1.3 of this license or any later version.

:Homepage:  https://codeberg.org/milde/greek-tex

:Latest Release: https://ctan.org/pkg/greek-fontenc

:Abstract: The `greek-fontenc` bundle provides LICR [#]_ macros
           for characters from the Greek script and encoding
           definition files for `Greek text font encodings`_.

           Included are also the LaTeX packages textalpha_ and alphabeta_.

.. [#] `LaTeX internal character representation` (LICR) macros can
   serve as a human readable 7-bit-ASCII character encoding that
   works unaltered under both, 8-bit TeX and XeTeX/LuaTeX.
   Use cases are macro definitions and generated text.

.. contents::


TeX files and packages
======================

Packages
--------

.. _textalpha:

`<textalpha.sty>`_: `Greek symbols in text <textalpha.sty.html>`_
  Use ``\textalpha`` ... ``\textOmega`` or Greek literal characters [#]_
  independent of font encoding and TeX engine.
  Documentation: textalpha-doc.pdf_

  .. _alphabeta:

`<alphabeta.sty>`_: `Greek symbols in text and math <alphabeta.sty.html>`_
  Use ``\alpha`` ... ``\Omega`` independent of text/math mode,
  font encoding, and TeX engine.
  Documentation: alphabeta-doc.pdf_

.. [#] requires greek-inputenc_

Font encoding definitions
-------------------------

.. _LGR font encoding definition file:

`<greek-fontenc.def>`_
  `Common Greek font encoding definitions <greek-fontenc.def.html>`_

`<lgrenc.def>`_
  `LGR Greek font encoding definitions. <lgrenc.def.html>`_

  .. _tuenc-greek:

`<tuenc-greek.def>`_
  `Extended Greek definitions for the TU font encoding <tuenc-greek.def.html>`_

`<puenc-greek.def>`_
  `Extended Greek definitions for PDF strings <puenc-greek.def.html>`_

Auxiliary files
---------------

`<alphabeta-lgr.def>`_
  Composite definitions for alphabeta_ with 8-bit TeX.
`<alphabeta-tuenc.def>`_
  Composite definitions for alphabeta_ with XeTeX/LuaTeX.
`<greek-euenc.def>`_
  Backwards compatibility file loading tuenc-greek.def_.
`<lgr2licr.lua>`_
  `LGR Transcription to Greek LICR transformation <lgr2licr.lua.html>`_.
  Provisional.

The source files can be converted with PyLit_ to reStructuredText_ and
with Docutils_ to the HTML documentation.


Usage examples and test documents
=================================

LGR test and usage example
  `<test-lgrenc.tex>`_, `<test-lgrenc.pdf>`_

TU test and usage example
  `<test-tuenc-greek.tex>`_, `<test-tuenc-greek.pdf>`_

Hyperref_ test and usage example
  `<hyperref-with-greek.tex>`_, `<hyperref-with-greek.pdf>`_

Test LICRs with non-Greek legacy 8-bit input encoding
  `<test-licr-input.tex>`_, `<test-licr-input.pdf>`_

Test Greek diacritics with standard accent macros
  `<test-diacritics.tex>`_, `<test-diacritics.pdf>`_


Download and Installation
=========================

The simplest way is to install this package from your distribution using
its installation manager.

Alternatively:

* Download the latest `release`_ from the package's `CTAN page`_ or a
  snapshot_ of the `greek-tex`_ repository.

* Unpack the source archive to a temporary location.

* Copy/Move/Link files ending in ``.def`` or ``.sty`` to a suitable place in
  the TeX search path.

.. _release:
    https://mirrors.ctan.org/language/greek/greek-fontenc.zip
.. _CTAN page: https://www.ctan.org/pkg/greek-fontenc
.. _greek-tex: https://codeberg.org/milde/greek-tex/
.. _snapshot: https://codeberg.org/milde/greek-tex/archive/master.zip


Conflicts
=========

The arabi_ package provides the Babel ``arabic`` option which loads
``arabicfnt.sty`` for font setup. This package overwrites the LICR macros
``\omega`` and ``\textomega`` with font selecting commands.  See the report
for Debian `bug 858987`_ for details and the `arabi workaround`_ below.

.. _bug 858987: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=858987

Usage
=====

There are several alternatives to set up the support for a Greek font
encoding provided by this bundle, e.g.:

Babel:
  Use the ``greek`` option with Babel_::

     \usepackage[greek]{babel}

  This automatically loads ``lgrenc.def`` with 8-bit TeX and
  ``tuenc-greek.def`` with XeTeX/LuaTeX and provides localized auto-strings,
  hyphenation and other localizations (see babel-greek_).

  Babel can be used together with textalpha_ or alphabeta_.

textalpha_:
  Ensure support for Greek characters in text mode::

     \usepackage{textalpha}

  eventually with the normalize-symbols_ option to handle `symbol variants`_
  and/or the keep-semicolon_ option to use the `semicolon as erotimatiko`_
  also in LGR ::

     \usepackage[normalize-symbols,keep-semicolon]{textalpha}

  This sets up LICR macros for Greek text charactes under both, 8-bit TeX
  and Xe-/LuaTeX.
  For details see `<textalpha-doc.tex>`_ and `<textalpha-doc.pdf>`_ (8-bit
  TeX) as well as `<test-tuenc-greek.tex>`_ and `<test-tuenc-greek.pdf>`_
  (XeTeX/LuaTeX).

  .. _normalize-symbols: textalpha.sty.html#normalize-symbols
  .. _keep-semicolon: textalpha.sty.html#keep-semicolon
  .. _semicolon as erotimatiko: textalpha.sty.html#semicolon-as-erotimatiko

alphabeta_:
  To use the short macro names (``\alpha`` ... ``\Omega``) known from math
  mode in both, text and math mode, write ::

     \usepackage{alphabeta}

  For details see `<alphabeta-doc.tex>`_ and `<alphabeta-doc.pdf>`_.

fontenc:
  Declare LGR via fontenc_. For example, specify T1 (8-bit
  Latin) as default font encoding and LGR for Greek with ::

     \usepackage[LGR,T1]{fontenc}

  Note that without textalpha_ or alphabeta_, Greek text macros work
  only if the current font encoding supports Greek. See [fntguide]_ for
  details and `<test-lgrenc.tex>`_ for an example.

  It is possible to use 8-bit Greek text fonts in the LGR TeX font encoding
  also with XeTeX/LuaTeX, if the fontenc_ package is loaded before
  Babel, textalpha_, or alphabeta_, e.g. ::

    \usepackage[LGR]{fontenc}
    \usepackage{fontspec}
    \setmainfont{Linux Libertine O} % Latin Modern does not support Greek
    \setsansfont{Linux Biolinum O}
    \usepackage{textalpha}

  See `<test-tuenc-greek.tex>`_, `<test-tuenc-greek.pdf>`_ and
  `<test-lgrenc.tex>`_, `<test-lgrenc.pdf>`_.

.. _arabi workaround:

To work around the conflict with arabi_, it may suffice to ensure ``greek``
is loaded after ``arabic``::

    \usepackage[arabic,greek,english]{babel}

More secure is an explicit reverse-definition, e.g. ::

    % save original \omega
    \let\mathomega\omega

    \usepackage[utf8]{inputenc}
    \usepackage[LAE,LGR,T1]{fontenc}
    \usepackage[arabic,greek,english]{babel}

    % fix arabtex:
    \DeclareTextSymbol{\textomega}{LGR}{119}
    \renewcommand{\omega}{\mathomega}


Greek text font encodings
=========================

Greek TeX font encodings are the envisaged T7_, LGR_, and LGI_.
Greek letters and symbols are also defined in the Unicode-based font
encodings TU_, and PU_.

T7
--

The [encguide]_ reserves the name T7 for a Greek `standard font encoding`.
However, up to now, there is no agreement on an implementation because the
restrictions for general text encodings are too severe for typesetting
polytonic Greek.

LGR
---

The LGR font encoding is the de-facto standard for typesetting Greek with
(8-bit) LaTeX. `greek-fontenc` provides a comprehensive `LGR font
encoding definition file`_.

Fonts in this encoding include the `CB fonts`_ (matching CM), grtimes_
(Greek Times), Kerkis_ (matching URW Bookman), DejaVu_, `Libertine GC`_, and
the `GFS fonts`_. Setup of these fonts as Greek variant to
matching Latin fonts is facilitated by the substitutefont_ package.


The LGR font encoding allows to access Greek characters via an ASCII
transliteration. This enables simple input with a Latin keyboard.
Characters with diacritics can be selected by ligature definitions in the
font (see [greek-usage]_, [teubner-doc]_, [cbfonts]_).

A major drawback of the transliteration is, that you cannot access Latin
letters if LGR is the active font encoding (e.g. in documents or parts of
documents given the `Babel` language ``greek`` or ``polutionikogreek``).
This means that for every Latin-written word or acronym an explicit
language-switch is required. This problem can only be solved via a
font-encoding comprising Latin and Greek like the envisaged T7_ or
Unicode (with XeTeX or LuaTeX).

LGI
---

The ‘Ibycus’ fonts from the package ibygrk_ implement an alternative
transliteration scheme (also explained in [babel-patch]_).
It is currently not supported by `greek-fontenc`.

The font encoding file ``lgienc.def`` from ibycus-babel_ provides a basic
setup (without any LICR macros or composite definitions).

TU
--

Standard Unicode font encoding for XeTeX and LuaTeX loaded by fontspec_
(since v2.5a) rsp. the LaTeX kernel since 2017/01/01 [ltnews26]_.
`greek-fontenc` adds support for the Greek script (see tuenc-greek_).

Xe/LuaTeX works with any system-wide installed `OpenType font`_. Suitable
fonts supporting Greek include `CM Unicode`_, `Deja Vu`_, `EB Garamond`_,
the `GFS fonts`_, `Libertine OTF`_, `Libertinus`_, `Old Standard`_,
Tempora_, and `UM Typewriter`_ (all available on CTAN) but also many commercial
fonts. Unfortunately, the fontspec_ default, `Latin Modern`_ misses most
Greek characters.

Older versions of LuaTeX did not apply the NFC normalization. This lead to
suboptimal placing of some diactritics, especially the sub-iota (becoming
unintelligable in combination with small letter eta). This issue if fixed
since at least 2022.

The legacy Unicode font encodings EU1 and EU2 for XeTeX and LuaTeX
respectively were superseded by TU in the 2017 fontspec_ release.

PU
--

The package hyperref_ defines the PU font encoding for use in PDF strings
(ToC, bookmarks) which supports monotonic Greek. `greek-fontenc` adds
support for polytonic Greek and some archaic characters also supported in
LGR and TU (see `<hyperref-with-greek.tex>`_, `<hyperref-with-greek.pdf>`_).


Greek LICR macro names
======================

.. note::   The LICR macro names for Greek symbols are chosen pending
            endorsement by the TeX community and related packages.

            Names for archaic characters, accents/diacritics, and
            punctuation may change in future versions.

This bundle provides LaTeX internal character representations (LICR macros)
for Greek letters and diacritics. Macro names were selected based on the
following considerations:

letters and symbols
-------------------

* The fntguide_ (section 6.4 Naming conventions) recommends:

     Where possible, text symbols should be named as ``\text`` followed
     by the **Adobe glyph name**: for example ``\textonequarter`` or
     ``\textsterling``. Similarly, math symbols should be named as
     ``\math`` followed by the glyph name, for example
     ``\mathonequarter`` or ``\mathsterling``.

  Problem:
     The `Adobe Glyph List For New Fonts`_ has names for many glyphs in the
     `Greek and Coptic` Unicode block, but not for `Greek extended`. The
     `Adobe Glyph List`_ (for existing fonts) lists additional glyph names
     used in older fonts.  However, these are not intended for active use.

* If there exists a **math-mode macro** for a symbol, the corresponding text
  macro could be formed by prepending ``text``.

  Example:
     The glyph name for the GREEK SMALL LETTER FINAL SIGMA is ``sigma1``,
     the corresponding math-macro is ``\varsigma``. The text symbol is
     made available as ``\textvarsigma``.

  Problem:
     `Symbol variants`_ (see below).

* The `Unicode names list`_ provides standardized descriptive names for all
  Unicode characters that use only capital letters of the Latin alphabet.
  While not suited for direct use in LICR macros, they can be either

  i.  used as inspiration for new LICR macro names or
  ii. converted to LICR macro names via a defined set of transformation rules.

  Example:
    ``\textfinalsigma`` is a descriptive alias for
    GREEK SMALL LETTER FINAL SIGMA derived via the rules:

    * drop "LETTER" if the name remains unique,
    * drop "GREEK" if the name remains unique,
    * use capitalized name for capital letters, lowercase for "SMALL" letters
      and drop "SMALL",
    * concatenate

* Omit the "text" prefix for macros that do not have a math counterpart?

  Pro:
    + Simpler,
    + ease of use (less typing, better readability of source text),
    + many established text macro names without "text",
    + ``text`` prefix does **not** mark a macro as encoding-specific or
      "inserting a glyph". There are e.g. font-changing macros (``\textbf``,
      ``\textit``) and encoding-changing macros (``\textcyr``).
    + There are examples of encoding-specific macros
      without the ``text``-prefix, especially for letters, see encguide_.

  Contra:
    - Less consistent,
    - possible name clashes
    - ``text`` prefix marks a macro as confined to text (as opposed to math)
      mode,

  The font encoding definition files use the ``text`` prefix for symbols.
  Aliases (short forms, compatibility defs, etc.) are defined in
  additional packages (e.g. alphabeta.sty_, `babel-greek`_, or teubner_)


accent macros
-------------

* standard accent macros (``\DeclareTextAccent`` definitions in
  ``latex/base/...``) are one-character macros (``\' \" ... \u \v ...``) .

* ``tipa.sty``, xunicode_, and ucs_ use the "text" prefix also for accents.

  However, the `Adobe Glyph List For New Fonts`_ maps, e.g., "tonos" and
  "dieresistonos" to the spacing characters GREEK TONOS and GREEK DIALYTIKA
  TONOS, hence `\texttonos` and `\textdiaresistonos` should be spacing
  characters.

* textcomp (ts1enc.def) defines ``\capital...`` accents (i.e. without
  ``text`` prefix).

Currently, `greek-fontenc` uses for diacritics:

- Greek names like in Unicode, and ``ucsencs.def``, and

- the prefix ``\acc`` to distinguish the macros as `TextAaccent` and
  reduce the risc of name clashes with spacing characters.

For the end-user "symbol macros" (``\~ \' \` \" \"' \"` ...``) are
provided. (With textalpha_ or alphabeta_ also ``\<`` and ``\>`` for
``\accdasia`` and ``\accpsili``.)


symbol variants
---------------

Mathematical notation distinguishes variant shapes for beta (β|ϐ),
theta (θ|ϑ), phi (φ|ϕ), pi (π|ϖ), kappa (κ|ϰ), rho (ρ|ϱ), Theta (Θ|ϴ),
and epsilon (ε|ϵ).

The variations have no syntactic meaning in Greek text and Greek text
fonts use the shape variants indiscriminately (cf. `glyph variants`__).
The variant shapes are not given separate code-points in the LGR_ text
font encoding.

In mathematical mode, TeX supports the alternative glyph variants with
``\var<lettername>`` macros (variant macros for ϴ, ϐ, and ϰ require
additional packages).

Unicode defines separate code points for the symbol variants for use in
mathematical context. [#]_ Unfortunately, the mapping between Unicode's
letter/symbol distinction and "normal"/variant in TeX is inconsistent.

`greek-fontenc` provides ``\text<lettername>symbol`` LICR macros for the
Greek symbol characters:

* With Unicode fonts, the macros select the GREEK <lettername> SYMBOL``.

* With LGR encoded fonts, they report an error by default.

  With the ``normalize-symbols`` option of textalpha_ and alphabeta_,
  they are mapped to the corresponding letter (loosing the distinction
  between the shape variants).

The `alphabeta`_ package provides ``\<lettername>``, ``\var<lettername>``,
and ``\<lettername>symbol`` in both, text and math mode (cf. Table 1 in
`<alphabeta-doc-tu.pdf>`_).


.. [#] However, they are sometimes also used in place of the
   corresponding letter characters in Unicode-encoded text.

__ http://en.wikipedia.org/wiki/Greek_alphabet#Glyph_variants


Changelog
=========

0.9 (2013-07-03)
    - ``greek-fontenc.def`` "outsourced" from ``lgrxenc.def``
    - experimental LICRs for XeTeX/LuaTeX.
0.9.1 (2013-07-18)
    - Bugfix: wrong breathings psilioxia -> dasiaoxia.
0.9.2 (2013-07-19)
    - Bugfix: Disable composite defs starting with char macro,
    - Fix "hiatus" handling.
0.9.3 (2013-07-24)
    - Fix path for ``\input`` of ``greek-fontenc.def``.
0.9.4 (2013-09-10)
    - ``greek-fontenc.sty``: Greek text font encoding setup package.
    - remove ``xunicode-greek.sty``.
0.10 (2013-09-13)
    - textalpha_ and alphabeta_ moved here from lgrx and updated to work
      with XeTeX/LuaTeX.
    - ``greek-fontenc.sty`` removed (obsoleted by textalpha_).
0.10.1 (2013-10-01)
    - Bugfix in ``greek-euenc.def`` and ``alphabeta-euenc.def``.
0.11 (2013-11-28)
    - Compatibility with Xe/LuaTeX in 8-bit mode.
    - ``\greekscript`` *TextCommand* (cf. [encguide]_).
0.11.1 (2013-12-01)
    - Fix identification of ``greek-euenc.def``.
0.11.2 (2014-09-04)
    - Documentation update, remove duplicate code.
0.12 (2014-12-25)
    - Fix auxiliary macro names in textalpha_.
    - Conservative naming: move definition of ``\<`` and ``\>`` from
      ``greek-fontenc.def`` to ``textalpha.sty`` (Bugreport David Kastrup).
0.13 (2015-09-04)
    - Support for `symbol variants`_,
    - ``keep-semicolon`` option in textalpha_,
    - ``\lccode``/``\uccode`` corrections for Unicode
      (from Apostolos Syropoulos’ xgreek_) in greek-euenc.
    - Do not convert ``\ypogegrammeni`` to ``\prosgegrammeni``
      with ``\MakeUppercase``.
0.13.1 (2015-12-07)
    - Fix `rho with dasia bug`__ in lgrenc.def (Linus Romer).
0.13.2 (2016-02-05)
    - Support for standard Unicode text font encoding "TU"
      (new in fontspec v2.5a).
0.13.3 (2019-07-10)
    - Drop error font declaration (cf. `ltxbugs 4399`_).
0.13.4 (2019-07-11)
    - "Lowercase" ``\prosgegrammeni`` -> ``\ypogegrammeni``
      but not vice versa.
0.14 (2020-02-28)
    - Rename ``greek-euenc`` to ``tuenc-greek``.
    - Use ``\UTFencoding`` instead of ``\LastDeclaredEncoding``.
1.0 (2020-09-25)
    - Bugfix in textalpha_: Let ``\greekscript`` set ``\encodingdefault``.
    - ``\textKoppa`` as alias for ``\textkoppa`` in LGR.
2.0 (2020-10-30)
    - Move common alias definitions to ``greek-fontenc.def``.
    - textalpha_ loads TU with Xe/LuaTeX by default and provides
      ``\textmicro`` and LICR macros for archaic symbols from the
      "Greek and Coptic" Unicode block.
    - Use ``\UnicodeEncodingName`` (by the LaTeX kernel) instead of
      ``\UTFencname`` for the Unicode font encoding name.
    - Replace utf8 literals in ``tuenc-greek.def``.
    - New file ``puenc-greek.def``: setup for PU encoding defined by
      hyperref_ for PDF strings.
    - Don't use ``\textcompwordmark`` as base in accent commands.
2.1 (2022-06-14)
    - Support the correct spelling ``\guillemet…`` for « and ».
      See https://github.com/latex3/latex2e/issues/65
2.2 (2023-02-28)
    - Use correct glyph for ``\textanoteleia`` (middle dot) in LGR.
    - Test and add composite commands for combinations that are not
      converted to pre-composed characters.
    - Don't use ``\makeatother`` in ``\AtBeginDocument``.
    - Skip ``\uccode`` fixes when ignored by ``\MakeUppercase``.
    - Various small fixes and documentation update.
2.2.1 (2023-03-08)
    - Fix broken links in README.md.
    - ``@uclclist`` entry for ``\accoxia``, prevent
      downcasing ``\textStigma`` to ``\textvarstigma``.
2.2.2 (2023-03-17)
    - Don't map active ``;`` to ``\textsemicolon`` in math mode.

2.3 (2023-06-01)
    - Fix Unicode errors with pdfLaTeX and "new" (2023) ``\MakeUppercase``.
    - Upcase symbol variants also if input as LICR.

__ http://tex.stackexchange.com/questions/281631/greek-small-rho-with-dasia-and-also-psili-problem-with-accent-and-lgr-encodin
.. _ltxbugs 4399:
   https://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex%2F4399&search=


References
==========

An alternative, more complete set of short mnemonic character names is
the `XML Entity Definitions for Characters`_ W3C Recommendation from
01 April 2010.

For glyph names of the LGR encoding see, e.g., ``CB.enc`` by Apostolos
Syropoulos and ``xl-lgr.enc`` from the libertine_ (legacy) package.
``lgr.cmap`` provides a mapping to Unicode characters.

A full set of ``\text*`` symbol macros is defined in ``ucsencs.def``
from the ucs_ package.

.. [babel-patch] Werner Lemberg, `Unicode support for the Greek LGR
   encoding` Εὔτυπον, τεῦχος  № 20, 2008.
   http://www.eutypon.gr/eutypon/pdf/e2008-20/e20-a03.pdf
.. [cbfonts] Claudio Beccari, `The CB Greek fonts`, Εὔτυπον, τεῦχος № 21, 2008.
   http://www.eutypon.gr/eutypon/pdf/e2008-21/e21-a01.pdf
.. [encguide] Frank Mittelbach, Robin Fairbairns, Werner Lemberg,
   LaTeX3 Project Team, `LaTeX font encodings`.
   https://mirrors.ctan.org/macros/latex/base/encguide.pdf
.. [fntguide] LaTeX3 Project Team, `LaTeX2ε font selection`.
   https://mirrors.ctan.org/macros/latex/base/fntguide.pdf
.. [greek-usage] Apostolos Syropoulos, `Writing Greek with the greek option
   of the babel package`, 1997.
   https://mirrors.ctan.org/language/babel/contrib/greek/usage.pdf
.. [ltnews26] LaTeX Project Team, `LaTeX News` Issue 26, January 2017.
   https://www.latex-project.org/news/latex2e-news/ltnews26.pdf
.. [teubner-doc] Claudio Beccari, ``teubner.sty``
   `An extension to the greek option of the babel package`, 2011.
   https://mirrors.ctan.org/macros/latex/contrib/teubner/teubner-doc.pdf

.. _LaTeX Project Public License: http://www.latex-project.org/lppl.txt
.. _PyLit: https://pypi.org/project/pylit/
.. _reStructuredText: https://docutils.sourceforge.io/rst.html
.. _Docutils: https://docutils.sourceforge.io/rst.html

.. _Adobe Glyph List For New Fonts:
    http://raw.githubusercontent.com/adobe-type-tools/agl-aglfn/master/aglfn.txt
.. _Adobe Glyph List:
    http://raw.githubusercontent.com/adobe-type-tools/agl-aglfn/master/glyphlist.txt
.. _Unicode names list: http://www.unicode.org/Public/UNIDATA/NamesList.txt
.. _XML Entity Definitions for Characters:
    http://www.w3.org/TR/xml-entity-names/
.. _CB fonts: https://ctan.org/pkg/cbgreek-complete
.. _CM Unicode: https://ctan.org/pkg/cm-unicode
.. _Deja Vu: http://dejavu-fonts.org
.. _EB Garamond: https://ctan.org/pkg/ebgaramond
.. _GFS fonts: https://ctan.org/pkg/gfs
.. _Kerkis: https://ctan.org/pkg/kerkis
.. _Latin Modern: http://www.gust.org.pl/projects/e-foundry/latin-modern
.. _Libertine OTF: https://ctan.org/pkg/libertineotf
.. _Libertine GC: https://ctan.org/pkg/libertinegc
.. _Libertinus: https://ctan.org/pkg/libertinus
.. _Old Standard: https://ctan.org/pkg/oldstandard
.. _OpenType Font: https://ctan.org/topic/font-otf
.. _UM Typewriter: https://ctan.org/pkg/umtypewriter
.. _amssymb: https://ctan.org/pkg/amsfonts
.. _arabi: https://ctan.org/pkg/arabi
.. _babel-greek: https://ctan.org/pkg/babel-greek
.. _babel: https://ctan.org/pkg/babel
.. _dejavu: https://ctan.org/pkg/dejavu
.. _fontenc:  https://ctan.org/pkg/fontenc
.. _fontspec:  https://ctan.org/pkg/fontspec
.. _greek-inputenc: https://ctan.org/pkg/greek-inputenc
.. _grtimes: https://ctan.org/pkg/grtimes
.. _hyperref: https://ctan.org/pkg/hyperref
.. _ibycus-babel: https://ctan.org/pkg/ibycus-babel
.. _ibygrk: https://ctan.org/pkg/ibygrk
.. _lgrx: https://ctan.org/pkg/lgrx
.. _libertine: https://ctan.org/pkg/libertine-legacy
.. _lua-uni-algos: https://ctan.org/pkg/lua-uni-algos
.. _substitutefont: https://ctan.org/pkg/substitutefont
.. _tempora: https://ctan.org/pkg/tempora
.. _teubner: https://ctan.org/pkg/teubner
.. _ucs: https://ctan.org/pkg/unicode
.. _unicode-math: https://ctan.org/pkg/unicode-math
.. _xgreek: https://ctan.org/pkg/xgreek
.. _xunicode: https://ctan.org/pkg/xunicode