summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/lgrx/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/lgrx/README')
-rw-r--r--Master/texmf-dist/doc/latex/lgrx/README303
1 files changed, 90 insertions, 213 deletions
diff --git a/Master/texmf-dist/doc/latex/lgrx/README b/Master/texmf-dist/doc/latex/lgrx/README
index dc5ffe8d41f..ab87415a71d 100644
--- a/Master/texmf-dist/doc/latex/lgrx/README
+++ b/Master/texmf-dist/doc/latex/lgrx/README
@@ -8,238 +8,94 @@ Greek text with the LGR font encoding
conditions of the `LaTeX Project Public License`_, either
version 1.3 of this license or any later version.
-:Abstract: The LGR font encoding is the de-facto standard for Greek
- typesetting with (8-bit) LaTeX. However, the encoding definition
- file that ships with babel_ misses many of the definitions common
- since the advent of the NFSS [fntguide]_.
+:Abstract: The `lgrx` bundle provides packages that help typesetting Greek
+ symbols with 8-bit LaTeX in multi-lingual documents.
- The `lgrx` bundle provides packages and definitions for
- typesetting Greek text with fonts in the LGR encoding. It works
- for both, monotonic and polytonic Greek, independent of the
- `babel` package.
- The bundle is available from CTAN__ and included in
- TeXLive 2012.
+News
+====
- __ http://www.ctan.org/pkg/lgrx
+: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_
-.. Note::
+:2013-05-28: The file ``lgrenc.dfu`` (support for Unicode input) moved to
+ the greek-inputenc_ package.
- The TeXLive 2012 pre-release contains 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
-
-.. contents::
-
-
-Manifest
-========
-
-The lgrx bundle consists of the following LaTeX files:
-
-LaTeX files:
- :lgrxenc.def: comprehensive LGR encoding definition file
- :lgrenc.dfu: support for Unicode input
- :textalpha.sty: ``\text...`` macros for Greek letters in non-Greek text
- :alphabeta.sty: Greek letters with ``\alpha``, ``\beta``, ... in text
- and math
-
- Literal sources:
- `<lgrxenc.def.html>`_, `<lgrenc.dfu.html>`_,
- `<textalpha.sty.html>`_, `<alphabeta.sty.html>`_
-
-Documentation and test documents:
- .. class:: run-in
-
- :`<diacritics.pdf>`_: `Greek diacritics with standard accent macros`
- source `<diacritics.tex>`__
- :`<greekhyperref.pdf>`_: `Greek script in PDF metadata`,
- source `<greekhyperref.tex>`__
- :`<greek-unicode.pdf>`_: `Greek Unicode with lgrenc.dfu`,
- source `<greek-unicode.tex>`__
- :`<lgrxenc-test.pdf>`_: source `<lgrxenc-test.tex>`__
- :`<textalpha-test.pdf>`_: source `<textalpha-test.tex>`__
- :`<alphabeta-test.pdf>`_: source `<alphabeta-test.tex>`__
-
-
-
-Motivation
-==========
-
-Greek font encodings
---------------------
-
-Unicode
-~~~~~~~
-
-The Unicode standard allows fonts that comprise glyphs from (almost) all
-known scripts. With the TeX engines XeTeX or LuaTeX, typesetting Greek with
-LaTeX is as easy as finding a font that contains Greek letters and setting
-it up with fontspec_. Beware, that you must not use the ``greek`` or
-``polutonikogreek`` options of the babel_ package. The `babel` replacement
-polyglossia_ provides Greek language support for XeLaTeX/LuaLaTeX.
-If you go this way, you don't need the lgrx bundle.
-
-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. Fonts in this encoding include the `CB fonts`_ (matching CM),
-grtimes_ (Greek Times), Kerkis_ (matching URW Bookman), and the `GFS font
-collection`_. Setup of these fonts as Greek variant to matching Latin fonts
-is facilitated by the substitutefont_ package.
-
-The LGR font encoding generates Greek characters via an ASCII
-transliteration. This enables simple input with a Latin keyboard.
-Characters with diacritics are selected by ligature definitions in the
-font (see [greek-usage]_, [teubner-doc]_, [cbfonts]_).
-
-A major drawback of this 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 explicite
-language-switch is required. This problem can only be solved via a
-font-encoding comprising Latin and Greek like the hypothetic T7_ or Unicode
-(with XeTeX or LuaTeX).
-
-\*OT7
-~~~~~
-
-The name LGR does not reflect status of this font encoding due to historical
-reasons. [encguide]_ classifies encodings starting with `L` as "local".
-Indeed, LGR started as a local encoding for the `CB fonts`_ by Claudio
-Beccari. Later, Apostolos Syropoulos advanced it to the default font
-encoding for the `babel` package's ``greek`` option. A better name would be
-OT7:
-
-* It is an 'old' encoding.
-* It implements a Latin transcription for a non-Latin script like the
- OT2 encoding.
-* It is not confined to 128 bit but OT4 shows that this is no
- absolute requirement for an `OT` encoding.
+:2013-06-03: ``alphabeta.sty`` enables Unicode input in math mode,
-However, due to the fact that the LGR font encoding has been used under its
-current name for a long time, the name will not change for compatibility
-reasons.
+ ``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.
-Problems with the default setup
--------------------------------
-
-The `lgrx` budle adresses a set of problems with the LGR font encoding as
-set up by `babel`:
-
-1. Ligatures with prefix notation prevent kerning (see the example document
- lgrxenc-test.pdf_ and [teubner-doc]_).
-
-2. Sub-optimal results with the standard accent macros:
-
- * no combined accents,
- * accents above (instead of before) capital letters,
- * pre-composed characters are not used.
-
-3. The tilde character ``~`` is used for a non-breaking space by
- default. Therefore the transliteration for the *perispomeni* accent is
- not available without re-definition of this character. [#tildehack]_
-
-4. The ``polutonikogreek`` `babel` option redefines both, ``~`` and ``\~``
- to produce accents via input ligatures (restricted to the language
- setting instead of the font encoding). This prevents the placing of a
- tilde-accent on non-supported characters like in *niño* if the language
- is set to polytonic Greek, even if ``\textlatin`` is used. [#poluhack]_
-
-5. There is no Unicode support with `inputenc`_'s ``utf8`` option.
+.. 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
- The `ucs` package contributed by Dominique Unruh provides Unicode support
- with the ``utf8x`` option. A babel patch by Werner Lemberg for Greek
- Unicode support [lemberg2008]_ never got applied.)
-6. The LGR transliteration does not work for PDF metadata.
+Files
+=====
-.. [#tildehack] Problem 3 can be solved by the simple one-liner ::
+LaTeX files:
+ :textalpha.sty: `Default text macros for Greek symbols`_ independent of
+ the current font encoding. Requires greek-fontenc_,
+ enhances greek-inputenc_.
- \DeclareTextSymbol{\~}{LGR}{126}
+ Literal source: `<textalpha.sty.html>`_
- which results in ``\~`` inserting a plain tilde character if the
- font encoding is LGR.
+ :alphabeta.sty: `Generic macros for Greek symbols`_ in text and math.
+ Requires ``textalpha.sty``.
- Drawback: you cannot place a ~-accent on Greek characters except the
- ones supported by an input ligature.
+ Literal source: `<alphabeta.sty.html>`_
-.. [#poluhack] Fortunately, LaTeX saves copies of the accent macros: ``\~``
- is an alias of ``\a~`` (which is an alias of ``\@tabacckludge~``), so it
- can be restored after loading `babel` with::
+ :lgrxenc.def: backwards compatibility file. New documents should use
+ greek-fontenc_'s ``lgrenc.def`` instead.
- \addto\extraspolutonikogreek{\renewcommand*{\~}{\a~}}
- \addto\extrasgreek{\renewcommand*{\~}{\a~}}
+Documentation and test documents:
+ .. class:: run-in
- With this addition, both the comprehensive font encoding definitions and
- the workaround [#tildehack]_ also work with the ``polutonikogreek``
- `babel` option.
+ :`<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 comprises tools that help typesetting Greek script
-with (8-bit) LaTeX in Greek as well as multi-lingual documents.
-
-Comprehensive font encoding definition file
--------------------------------------------
-
-``lgrxenc.def`` is an alternative to the rudimentary LGR encoding definition
-file [#fdf]_ ``lgrenc.def`` which comes with babel_'s Greek support. It
-defines LICR macros for Greek characters that select pre-composed glyphs if
-possible and places the diacritics according to Greek typesetting rules
-else. Combined accents can be specified as backslash + transliteration
-(``\~>a``) or iteratively (``\~\>{a}``).
-For usage and documentation see the literal source lgrxenc.def.html_, the
-user manual diacritics.pdf_, and the test document lgrxenc-test.pdf_.
+The `lgrx` bundle consists of the `textalpha` and `alphabeta` packages and
+the backwards compatibility file ``lgrxenc.def``.
-.. [#fdf] See [fntguide_, section 5] for a definition of `encoding definition
- files`.
-UTF-8 support for Greek
------------------------
-
-``lgrenc.dfu`` provides standards-compatible UTF-8 support for Greek based
-on the comprehensive font encoding definitions. It is compatible with
-hyperref_ enabling Greek characters in PDF metadata without the need for
-``\texorpdfstring``.
-
-See the literal source lgrenc.dfu.html_ and the test document
-greek-unicode.pdf_.
+Default text macros for Greek symbols
+-------------------------------------
-Text macros for Greek symbols
------------------------------
-
-``textalpha.sty`` makes the ``\textalpha``, ``\textbeta`` ... macros as well
-as the ``\ensuregreek`` command aviable in any font encoding. With this
-package, Unicode input of Greek letters works in any font encoding, too.
+``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 ``\Dasia\Tonos``) fails,
+* 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 textalpha-test.pdf_ for
-details on usage, limitations, and recommended workarounds.
+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
--------------------------------
@@ -248,8 +104,25 @@ Generic macros for Greek symbols
and math mode. For this, the math macros are redefined with the help of
``\TextOrMath`` from the standard package fixltx2e_.
-See the literal source alphabeta.sty.html_ and the test document
-alphabeta-test.pdf_.
+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
@@ -268,23 +141,27 @@ References
.. [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,
+.. [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://mirror.ctan.org/help/Catalogue/entries/cbgreek-complete.html
-.. _grtimes: http://mirror.ctan.org/help/Catalogue/entries/grtimes.html
-.. _GFS font collection: http://mirror.ctan.org/help/Catalogue/entries/gfs.html
-.. _Kerkis: http://mirror.ctan.org/help/Catalogue/entries/kerkis.html
-.. _substitutefont: http://mirror.ctan.org/help/Catalogue/entries/substitutefont.html
-.. _babel: http://mirror.ctan.org/help/Catalogue/entries/babel.html
-.. _fontenc: http://mirror.ctan.org/help/Catalogue/entries/fontenc.html
-.. _inputenc: http://mirror.ctan.org/help/Catalogue/entries/inputenc.html
-.. _fontspec: http://mirror.ctan.org/help/Catalogue/entries/fontspec.html
-.. _polyglossia: http://mirror.ctan.org/help/Catalogue/entries/polyglossia.html
-.. _textgreek: http://mirror.ctan.org/help/Catalogue/entries/textgreek.html
-.. _fixltx2e: http://mirror.ctan.org/help/Catalogue/entries/fixltx2e.html
-.. _hyperref: http://mirror.ctan.org/help/Catalogue/entries/hyperref.html
-.. _bookmark: http://mirror.ctan.org/help/Catalogue/entries/bookmark.html
+.. _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