summaryrefslogtreecommitdiff
path: root/language/greek/greek-fontenc/README
diff options
context:
space:
mode:
Diffstat (limited to 'language/greek/greek-fontenc/README')
-rw-r--r--language/greek/greek-fontenc/README193
1 files changed, 114 insertions, 79 deletions
diff --git a/language/greek/greek-fontenc/README b/language/greek/greek-fontenc/README
index fe1ffd9a64..bd6c0ce0cd 100644
--- a/language/greek/greek-fontenc/README
+++ b/language/greek/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