diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/lgrx/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/lgrx/README | 303 |
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 |