summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/lgrx/README
blob: ab87415a71dd0502410031354402546c8074e520 (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
.. -*- rst-mode -*-

Greek text with the LGR font encoding
***************************************

:Copyright: © 2010 Günter Milde
: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.

:Abstract: The `lgrx` bundle provides packages that help typesetting Greek
           symbols with 8-bit LaTeX in multi-lingual documents.


News
====

:2013-05-28: The new package greek-fontenc_ provides a comprehensive LGR
             font encoding file ``lgrenc.def``, that supersedes both this
             bundles ``lgrxenc.def`` and the minimal ``lgrenc.def``
             that used to be part of babel-greek_

:2013-05-28: The file ``lgrenc.dfu`` (support for Unicode input) moved to
             the greek-inputenc_ package.

:2013-06-03: ``alphabeta.sty`` enables Unicode input in math mode,

             ``textalpha.sty`` and ``alphabeta.sty`` require ``lgrenc.def``
             from greek-fontenc_ instead of ``lgrxenc.def``,

             ``lgrxenc.def`` now loads ``lgrenc.def`` and adds some
             backwards compatibility definitions.

.. note:: The TeXLive 2012 pre-release contained the Unicode definition file
   ``lgrenc.dfu`` in the documentation instead of the TEXPATH. To enable
   `utf-8 support for Greek`_, update via `tlmgr` or place a copy in the
   TEXPATH «by hand». See
   http://tug.org/pipermail/tex-live/2012-June/031757.html



Files
=====

LaTeX files:
  :textalpha.sty: `Default text macros for Greek symbols`_ independent of
                  the current font encoding. Requires greek-fontenc_,
                  enhances greek-inputenc_.

                  Literal source: `<textalpha.sty.html>`_

  :alphabeta.sty: `Generic macros for Greek symbols`_ in text and math.
                  Requires ``textalpha.sty``.

                  Literal source: `<alphabeta.sty.html>`_

  :lgrxenc.def:   backwards compatibility file. New documents should use
                  greek-fontenc_'s ``lgrenc.def`` instead.

Documentation and test documents:
  .. class:: run-in

  :`<textalpha-test.pdf>`_: `The textalpha package`,
                            source `<textalpha-test.tex>`__
  :`<alphabeta-test.pdf>`_: `The alphabeta package`,
                            source `<alphabeta-test.tex>`__
  :`<lgrxenc-test.pdf>`_:   source `<lgrxenc-test.tex>`__


Components of the `lgrx` bundle
===============================


The `lgrx` bundle consists of the `textalpha` and `alphabeta` packages and
the backwards compatibility file ``lgrxenc.def``.


Default text macros for Greek symbols
-------------------------------------

``textalpha.sty`` makes the ``\textalpha``, ``\textbeta`` ... macros as well as
the ``\ensuregreek`` command aviable in any font encoding. With the
greek-inputenc_ package, Unicode input of Greek letters works in any font
encoding, too.

.. _limitations:

However, in any font encoding except LGR:

* there is no kerning between Greek characters,
* composition of diacritics (like ``\'"``) fails,
* accent macros do not select precomposed characters
  (pre-composed Unicode literals work fine).

See the literal source textalpha.sty.html_ and the example document
textalpha-test.pdf_ for details on usage, limitations, and recommended
workarounds.


Generic macros for Greek symbols
--------------------------------

``alphabeta.sty`` allows you to use ``\alpha``, ``\beta``, ... in both, text
and math mode. For this, the math macros are redefined with the help of
``\TextOrMath`` from the standard package fixltx2e_.

Unicode input of Greek letters works also in mathematical formulas.

See the literal source alphabeta.sty.html_ and the example document
alphabeta-test.pdf_ for details.


LGR font encoding definition file
---------------------------------

``lgrxenc.def`` was an alternative to the rudimentary LGR encoding
definition file ``lgrenc.def`` that came with babel_'s Greek
support. It is now superseded by ``lgrenc.def`` from greek-fontenc_ but kept
here for backwards compatibility.


UTF-8 support for Greek
-----------------------

Moved to the greek-inputenc_ package.


References
==========

.. [fntguide] LaTeX3 Project Team, `LaTeX 2ε font selection`, 2005.
   http://mirror.ctan.org/macros/latex/doc/fntguide.pdf
.. [encguide] Frank Mittelbach, Robin Fairbairns, Werner Lemberg,
   LaTeX3 Project Team, `LaTeX font encodings`, 2006.
   http://mirror.ctan.org/macros/latex/doc/encguide.pdf
.. [greek-usage] Apostolos Syropoulos, `Writing Greek with the greek option
   of the babel package`, 1997.
   http://www.tug.org/texlive/Contents/live/texmf-dist/doc/generic/babel/greek-usage.pdf
.. [cbfonts] Claudio Beccari, `The CB Greek fonts`, Εὔτυπον, τεῦχος № 21, 2008.
   http://www.eutypon.gr/eutypon/pdf/e2008-21/e21-a01.pdf
.. [teubner-doc] Claudio Beccari, ``teubner.sty``
   `An extension to the greek option of the babel package`, 2011.
   http://mirror.ctan.org/macros/latex/contrib/teubner/teubner-doc.pdf
.. [lemberg2008] Werner Lemberg,
   `Unicode support for the Greek LGR encoding`, Εὔτυπον, τεῦχος № 20, 2008.
   http://www.eutypon.gr/eutypon/pdf/e2008-20/e20-a03.pdf


.. _LaTeX Project Public License: http://www.latex-project.org/lppl.txt
.. _CB Fonts: http://www.ctan.org/pkg/cbgreek-complete
.. _grtimes: http://www.ctan.org/pkg/grtimes
.. _GFS font collection: http://www.ctan.org/pkg/gfs
.. _Kerkis: http://www.ctan.org/pkg/kerkis
.. _lgrx: http://www.ctan.org/pkg/lgrx
.. _substitutefont: http://www.ctan.org/pkg/substitutefont
.. _babel: http://www.ctan.org/pkg/babel
.. _babel-greek: http://www.ctan.org/pkg/babel-greek
.. _fontenc:  http://www.ctan.org/pkg/fontenc
.. _inputenc: http://www.ctan.org/pkg/inputenc
.. _fontspec:  http://www.ctan.org/pkg/fontspec
.. _greek-fontenc: http://www.ctan.org/pkg/greek-fontenc
.. _greek-inputenc: http://www.ctan.org/pkg/greek-inputenc
.. _polyglossia: http://www.ctan.org/pkg/polyglossia
.. _textgreek: http://www.ctan.org/pkg/textgreek
.. _fixltx2e: http://www.ctan.org/pkg/fixltx2e
.. _hyperref: http://www.ctan.org/pkg/hyperref
.. _bookmark: http://www.ctan.org/pkg/bookmark