diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/greek-fontenc/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/greek-fontenc/README | 193 |
1 files changed, 114 insertions, 79 deletions
diff --git a/Master/texmf-dist/doc/latex/greek-fontenc/README b/Master/texmf-dist/doc/latex/greek-fontenc/README index fe1ffd9a64c..bd6c0ce0cd3 100644 --- a/Master/texmf-dist/doc/latex/greek-fontenc/README +++ b/Master/texmf-dist/doc/latex/greek-fontenc/README @@ -14,24 +14,21 @@ Greek font encoding definition files under both, 8-bit TeX and XeTeX/LuaTeX. Use cases are macro definitions and generated text - This package provides `Greek LICR macros`_ and encoding - definition files for `Greek text font encodings`_ for use with - fontenc_ (8-bit TeX) or fontspec_ (XeTeX/LuaTeX). + This bundle provides LICR macros for characters from the + Greek script and encoding definition files for + `Greek text font encodings`_ for use with fontenc_ (8-bit TeX) + or fontspec_ (XeTeX/LuaTeX). Included are also the LaTeX packages textalpha_ and alphabeta_. -.. 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. +.. contents:: Changelog ========= .. class:: borderless -====== =========== ========================================================== +====== =========== =========================================================== 0.9 2013-07-03 greek-fontenc.def_ "outsourced" from lgrxenc.def .. experimental files xunicode-greek.sty and greek-euenc.def: LICRs for XeTeX/LuaTeX. @@ -73,7 +70,18 @@ Changelog ``\encodingdefault``. .. ``\textKoppa`` as alias for ``\textkoppa`` in LGR. .. Update URLs. -====== =========== ========================================================== +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. +.. Documentation update. +====== =========== =========================================================== __ http://tex.stackexchange.com/questions/281631/greek-small-rho-with-dasia-and-also-psili-problem-with-accent-and-lgr-encodin .. _ltxbugs 4399: @@ -83,25 +91,33 @@ __ http://tex.stackexchange.com/questions/281631/greek-small-rho-with-dasia-and- TeX files ========= -`<greek-fontenc.def>`_ - `Common Greek font encoding definitions <greek-fontenc.def.html>`_. - -`<greek-euenc.def>`_ - Backwards compatibility file loading tuenc-greek_. - -.. _LGR font encoding definition file: - `<lgrenc.def>`_ `LGR Greek font encoding definitions <lgrenc.def.html>`_. This file is the successor of the basic LGR encoding definition file which comes with babel_'s Greek support and the now obsolete lgrx_ bundle. + .. _tuenc-greek: + +`<tuenc-greek.def>`_ + `Font setup for Greek with XeTeX/LuaTeX <tuenc-greek.def.html>`_. + +`<puenc-greek.def>`_ + `Greek LICR definitions for PDF strings <puenc-greek.def.html>`_. + +`<greek-fontenc.def>`_ + `Common Greek font encoding definitions <greek-fontenc.def.html>`_. + + .. _LGR font encoding definition file: + +`<greek-euenc.def>`_ + Backwards compatibility file loading tuenc-greek_. + .. _textalpha: `<textalpha.sty>`_ `Greek symbols in text <textalpha.sty.html>`_ - + Use ``\textalpha`` ... ``\textOmega`` independent of font encoding and TeX engine. @@ -109,18 +125,17 @@ TeX files `<alphabeta.sty>`_ `Greek symbols in text and math <alphabeta.sty.html>`_. - + Use ``\alpha`` ... ``\Omega`` independent of text/math mode, font encoding, and TeX engine. - -`<alphabeta-tuenc.def>`_ - `Composite definitions with XeTeX/LuaTeX. <alphabeta-tuenc.def.html>`_. - .. _tuenc-greek: + `<alphabeta-lgr.def>`_ + `Composite definitions for 8-bit TeX. <alphabeta-lgr.def.html>`_. + + `<alphabeta-tuenc.def>`_ + `Composite definitions with XeTeX/LuaTeX. <alphabeta-tuenc.def.html>`_. -`<tuenc-greek.def>`_ - `Font setup for Greek with XeTeX/LuaTeX <tuenc-greek.def.html>`_. Literate source files were converted with PyLit_ to reStructuredText_ and with Docutils_ to the HTML documentation. @@ -129,23 +144,30 @@ with Docutils_ to the HTML documentation. Documentation and test documents ================================ -`textalpha` package documentation: - `<textalpha-doc.tex>`__, `<textalpha-doc.pdf>`_ +Overview: + `<README>`__, `<greek-fontenc.html>`_ + +textalpha_ package documentation: + `<textalpha-doc.tex>`__, `<textalpha-doc.pdf>`_, `<textalpha-tu.pdf>`_ -`alphabeta` package documentation: - `<alphabeta-doc.tex>`__ `<alphabeta-doc.pdf>`_ +alphabeta_ package documentation: + `<alphabeta-doc.tex>`__, `<alphabeta-doc.pdf>`_, `<alphabeta-tu.pdf>`_ -Test and usage example - `<lgrenc-test.tex>`_, `<lgrenc-test.pdf>`_ +LGR test and usage example + `<test-lgrenc.tex>`_, `<test-lgrenc.pdf>`_ -Font setup for Greek with XeTeX/LuaTeX - `<tuenc-greek-doc.tex>`_, `<tuenc-greek-doc.pdf>`_ +TU test and usage example + `<test-tuenc-greek.tex>`_, `<test-tuenc-greek.pdf>`_ -Greek script in PDF metadata - `<greekhyperref.tex>`_, `<greekhyperref.pdf>`_ +Hyperref_ test and usage example + `<hyperref-with-greek.tex>`_, `<hyperref-with-greek.pdf>`_ + +Test with input encodings other than utf-8 + `<test-inputenc.tex>`_, `<test-inputenc.pdf>`_ + +Greek diacritics with standard accent macros + `<diacritics.tex>`_, `<diacritics.pdf>`_ - The package hyperref_ defines the PU font encoding which also supports - (monotonic) Greek. Experimental files ================== @@ -161,7 +183,7 @@ with other packages or removed in future versions: Installation ============ -If possible, get this package from your distribution using its installation +If possible, get the bundle from your distribution using its installation manager. Otherwise, make sure LaTeX can find the package and definition files: @@ -186,18 +208,25 @@ Usage ===== There are several alternatives to set up the support for a Greek font -encoding provided by this package, e.g.: +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`_ :: - - \usepackage[normalize-symbols]{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 :: @@ -206,7 +235,7 @@ 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 `<tuenc-greek-doc.tex>`_ and `<tuenc-greek-doc.pdf>`_ + TeX) as well as `<test-tuenc-greek.tex>`_ and `<test-tuenc-greek.pdf>`_ (XeTeX/LuaTeX). .. _normalize-symbols: textalpha.sty.html#normalize-symbols @@ -221,17 +250,6 @@ alphabeta_: For details see `<alphabeta-doc.tex>`_ and `<alphabeta-doc.pdf>`_. -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_. - fontenc: Declare LGR via fontenc_. For example, specify T1 (8-bit Latin) as default font encoding and LGR for Greek with :: @@ -240,11 +258,11 @@ fontenc: Note that without textalpha_ or alphabeta_, Greek text macros work only if the current font encoding supports Greek. See [fntguide]_ for - details and `<lgrenc-test.tex>`_ for an example. + 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 - fontspec_ and textalpha_ or alphabeta_, e.g. :: + Babel, textalpha_, or alphabeta_, e.g. :: \usepackage[LGR]{fontenc} \usepackage{fontspec} @@ -252,8 +270,8 @@ fontenc: \setsansfont{Linux Biolinum O} \usepackage{textalpha} - See `<tuenc-greek-doc.tex>`_, `<tuenc-greek-doc.pdf>`_ and - `<lgrenc-test.tex>`_, `<lgrenc-test.pdf>`_. + See `<test-tuenc-greek.tex>`_, `<test-tuenc-greek.pdf>`_ and + `<test-lgrenc.tex>`_, `<test-lgrenc.pdf>`_. .. _arabi workaround: @@ -281,7 +299,7 @@ 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_, `EU1, EU2`_, and PU (hyperref_). +encodings TU_, and PU_. T7 -- @@ -291,7 +309,6 @@ 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 --- @@ -332,8 +349,8 @@ TU -- Standard Unicode font encoding for XeTeX and LuaTeX loaded by fontspec_ -(since v2.5a). `greek-fontenc` adds support for the Greek script (see -tuenc-greek_). +(since v2.5a) rsp. the LaTeX kernel since 2017/01/01 [LaTeX2e News Issue 26]_. +`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`_, @@ -342,17 +359,38 @@ Tempora_, and `UM Typewriter`_ (all available on CTAN) but also many commercial fonts. Unfortunately, the fontspec_ default, `Latin Modern`_ misses most Greek characters. -EU1, EU2 --------- +XeTeX uses the Unicode NFC normalization, so that combining characters +are merged with the base character if a pre-composed character exists. This +results in better looking output for characters with multiple diacritics. +Unfortunately, LuaTeX does not apply the NFC normalization. This leads to +suboptimal placing of some diactritics, especially the sub-iota (becoming +unintelligable in combination with small letter eta). + +TODO: The `lua-uni-algos`_ package may be helpfull to implement a NTC +normalization to Greek text in LuaTeX. + +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>`_). -Legacy Unicode font encodings for XeTeX and LuaTeX respectively. Superseded -by TU_. +Selecting Greek LICR macro names +================================ -Greek LICR macros -================= +.. note:: The LICR macro names for Greek symbols are chosen pending + endorsement by the TeX community and related packages. -This package provides LaTeX internal character representations (LICR macros) + 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: @@ -493,7 +531,7 @@ characters: References ----------- +========== An alternative, more complete set of short mnemonic character names is the `XML Entity Definitions for Characters`_ W3C Recommendation from @@ -506,11 +544,6 @@ Syropoulos and ``xl-lgr.enc`` from the libertine_ (legacy) package. A full set of ``\text*`` symbol macros is defined in ``ucsencs.def`` from the ucs_ package. -Aliases from ``puenc.def`` ensure that the hyperref_ package can convert -Greek text in "LICR encoding" to a PDF-string (utf-8 encoded input is used -as-is). - - .. [fntguide] LaTeX3 Project Team, `LaTeX2ε font selection`, 2005. http://mirror.ctan.org/macros/latex/base/fntguide.pdf .. [encguide] Frank Mittelbach, Robin Fairbairns, Werner Lemberg, @@ -524,7 +557,8 @@ as-is). .. [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 - +.. [LaTeX2e News Issue 26] + https://www.latex-project.org/news/latex2e-news/ltnews26.pdf .. [babel-patch] Werner Lemberg, `Unicode support for the Greek LGR encoding` Εὔτυπον, τεῦχος № 20, 2008. http://www.eutypon.gr/eutypon/pdf/e2008-20/e20-a03.pdf @@ -569,6 +603,7 @@ as-is). .. _ibygrk: http://www.ctan.org/pkg/ibygrk .. _lgrx: http://www.ctan.org/pkg/lgrx .. _libertine: http://www.ctan.org/pkg/libertine-legacy +.. _lua-uni-algos: https://ctan.org/pkg/lua-uni-algos .. _substitutefont: http://www.ctan.org/pkg/substitutefont .. _tempora: https://www.ctan.org/pkg/tempora .. _teubner: http://www.ctan.org/pkg/teubner |