.. -*- 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
