summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/greek-fontenc/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/greek-fontenc/README')
-rw-r--r--Master/texmf-dist/doc/latex/greek-fontenc/README234
1 files changed, 211 insertions, 23 deletions
diff --git a/Master/texmf-dist/doc/latex/greek-fontenc/README b/Master/texmf-dist/doc/latex/greek-fontenc/README
index 71d869868ad..f1934a3a0ac 100644
--- a/Master/texmf-dist/doc/latex/greek-fontenc/README
+++ b/Master/texmf-dist/doc/latex/greek-fontenc/README
@@ -25,31 +25,46 @@ Greek font encoding definition files
Files
=====
+`<greek-fontenc.def>`_
+ `Common Greek font encoding definitions <greek-fontenc.def.html>`_.
+
`<lgrenc.def>`_
- font encoding definitions for LGR
+ font encoding definitions for LGR_.
+
+ The literate source `<lgrenc.def.txt>`_ was converted with PyLit_ to TeX
+ code and with Docutils_ to the documentation `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 ``lgrxenc.def`` from the lgrx_
- bundle. 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 (``\~>\textalpha``) or iteratively
- (``\~\>\textalpha``).
-
-`<lgrenc.def.txt>`_
- literate source (reStructuredText_ format)
+ bundle.
+
+`<lgrenc-test.pdf>`_
+ test example, source `<lgrenc-test.tex>`_,
+
+`<greekhyperref.pdf>`_
+ `Greek script in PDF metadata`, source `<greekhyperref.tex>`_
-`<lgrenc.def.html>`_
- literate source (HTML format)
+ The package hyperref_ defines the PU font encoding which also supports
+ (monotonic) Greek.
-`<lgrenc-test.tex>`_
- test example
+Experimental files that are still in development and will eventually be
+moved to/merged with other packages:
-`<lgrenc-test.pdf>`_
- test output
+`<xunicode-greek.sty>`_
+ `xunicode extension for Greek <xunicode-greek.sty.html>`_
+
+`<test-xunicode.tex>`_
+ Example for use of the experimental Greek LICR definitions with XeTeX.
+
+`<greek-euenc.def>`_
+ `Greek LICR definitions for XeTeX and LuaTeX <greek-euenc.def.html>`_
+
+`<test-euenc.tex>`_
+ Example for use of the experimental Greek LICR definitions with XeTeX.
-The literate source was converted with PyLit_ to TeX and with Docutils_ to
-HTML format.
+`<lgr2licr.lua>`_
+ `LGR Transcription to Greek LICR transformation <lgr2licr.lua.html>`_
Installation
@@ -58,12 +73,14 @@ Installation
If possible, get this package from your distribution using its installation
manager.
-Otherwise, make sure LaTeX can find the file `lgrenc.def`:
+Otherwise, make sure LaTeX can find the files ``lgrenc.def``,
+``greek-fontenc.def`` and eventually ``xunicode-greek.sty`` and
+``greek-euenc.def``:
-* Download and unpack `greek-fontenc.zip` or just download `<lgrenc.def>`_.
+* Download and unpack ``greek-fontenc.zip``.
-* Copy/Move/Link ``lgrenc.def`` to a suitable place in the TDS_ and run
- ``texhash``, or place it in the current working directory (e.g. for
+* Copy/Move/Link the files to a suitable place in the TDS_ and run
+ ``texhash``, or place them in the current working directory (e.g. for
testing).
Usage
@@ -76,6 +93,24 @@ Pass the encoding name as option to fontenc_. For example, specify T1
See [fntguide]_ for details and `<lgrenc-test.tex>`_ for an example.
+For XeTeX/LuaTeX, you can specify the EU1/EU2 encoding and
+load the experimental ``xunicode-greek``::
+
+ \usepackage[EU1]{fontenc} % XeTeX
+ % \usepackage[EU2]{fontenc} % LuaTeX
+ \usepackage{xunicode-greek}
+
+or ``greek-euenc.def``::
+
+ \usepackage[EU1]{fontenc} % XeTeX
+ % \usepackage[EU2]{fontenc} % LuaTeX
+ \makeatletter
+ \input{greek-euenc.def}
+ \makeatother
+
+However, XeTeX/LuaTeX usage details are very likely to change in the
+future!!!
+
Greek text font encodings
=========================
@@ -123,11 +158,153 @@ transliteration scheme (also explained in [babel-patch]_).
It is currently not supported by `greek-fontenc`.
The font encoding file ``lgienc.def`` from ibycus-babel_ provides a basic
-setup (without LICR macros or composite definitions).
+setup (without any LICR macros or composite definitions).
+
+
+Greek LICR macro names
+======================
+
+This package provides LaTeX internal character representations (LICR macros)
+for Greek letters and diacritics. Macro names were selected based on the
+following considerations:
+
+The fntguide_ (section 6.4 Naming conventions) recommends:
+
+ Where possible, text symbols should be named as ``\text`` followed
+ by the Adobe glyph name: for example ``\textonequarter`` or
+ ``\textsterling``. Similarly, math symbols should be named as
+ ``\math`` followed by the glyph name, for example
+ ``\mathonequarter`` or ``\mathsterling``.
+
+The `Adobe Glyph List For New Fonts`_ has names for many glyphs in the
+`Greek and Coptic` Unicode block, but not for `Greek extended`. The `Adobe
+Glyph List`_ (for existing fonts) lists additional glyph names used in older
+fonts. As these are not intened for further active use, the latter are not
+considered in the name choice.
+
+Proposals
+---------
+
+* If there exists a math-mode macro for a symbol, form the corresponding text
+ macro by prepending ``text``?
+
+ Example:
+ The glyph name for the GREEK SMALL LETTER FINAL SIGMA is ``sigma1``,
+ the corresponding math-macro is ``\varsigma``. The text symbol could be
+ made available as ``\textvarsigma``.
+
+ Problems:
+ ``\varepsilon`` and ``\varphi`` math macros map to characters named
+ "GREEK SMALL **LETTER** ...", while ``\\vartheta``, ``\\varkappa``,
+ ``\\varrho``, and ``\\varpi`` math macros map to "GREEK ... **SYMBOL**"
+ Unicode characters.
+
+ In Greek text, these variants are interchangeable. The LGR font encoding
+ does not contain slots for "symbol" glyph variants. In some Greek fonts,
+ GREEK SMALL LETTERS use glyph variants resembling the corresponding
+ GREEK SYMBOL Unicode character's reference glyph.
+
+* Derive macro names from Unicode names?
+
+ The `Unicode names list`_ provides standardized descriptive names for all
+ Unicode characters that use only capital letters of the Latin alphabet.
+ While not suited for direct use in a LICR macros, they can be either
+
+ a) used as inspiration for new LICR macro names or
+
+ b) converted to LICR macro names via a defined set of transformation rules.
+
+ Example:
+ ``\textfinalsigma`` or just ``\finalsigma`` as a more descriptive name
+ for GREEK SMALL LETTER FINAL SIGMA derived via the rules:
+
+ * drop "LETTER" if the name remains unique,
+ * drop "GREEK" if the name remains unique,
+ * use capitalized name for capital letters, lowercase for "SMALL" letters
+ and drop "SMALL",
+ * concatenate
+
+* Omit the "text" prefix for macros that do not have a math counterpart?
+
+ Pro:
+ + Simpler,
+
+ + ease of use (less typing, better readability of source text),
+
+ + many established text macro names without "text",
+
+ + there are examples of encoding-specific macros
+ without the ``text``-prefix, especially for letters,
+
+ :T1: ``\AE \DH \DJ \L \NG \OE \O \SS \TH \ae \dh \dj \guillemotleft``
+ ``\guillemotright \guilsinglleft \guilsinglright \i \j \l \ng``
+ ``\oe \o \quotedblbase \quotesinglbase \ss \th`` (also in OT1)
+ :T2*: ``\CYR*`` and ``\cyr*``
+ :HE8: ``\heb*`` or no prefix
+ :PU: short descriptive names in the arabic part (``puarenc.def``)
+
+ + ``text`` prefix does **not** mark a macro as encoding-specific or
+ "inserting a glyph". There are e.g. font-changing macros (``\textbf``,
+ ``\textit``) and encoding-changing macros (``\textgreek``,
+ ``\textcyr``).
+
+ Contra:
+ - Less consistent.
+
+ - ``text`` prefix marks a macro as confined to text mode.
+
+ Conclusion:
+ To avoid name clashes, this package uses the ``text`` prefix
+ for symbols. Aliases (short forms, compatibility defs, etc.) can be
+ defined in packages.
+
+
+How to name *accent macros*?
+----------------------------
+
+* standard accent macros (``\DeclareTextAccent`` definitions in
+ ``latex/base/...``) are one-symbol macros (``\' \" ... \u \v ...``) .
+
+* ``tipa.sty``, ``xunicode``, and ucs_ use the "text" prefix also for accents.
+
+ However, the `Adobe Glyph List For New Fonts`_ maps, e.g., "tonos" and
+ "dieresistonos" to 0384 GREEK TONOS and 0385 GREEK DIALYTIKA TONOS, hence
+ `\texttonos` and `\textdiaresistonos` should be spacing characters.
+
+* textcomp (ts1enc.def) defines ``\capital...`` accents (i.e. without
+ ``text`` prefix).
+
+* Use a common prefix ``\textaccent...``, ``\accent...``,
+ or just ``\acc...`` (cf ``\@tabacckludge``)?
+
+Currently, `greek-fontenc` uses for diacritics:
+
+- Greek names like in Unicode, and ucsencs.def
+
+- The prefix "acc" to distinguish the macros as `TextAaccent` and reduce the
+ risc of name clashes.
+
+- For the end-user "symbol macros" (``\~ \' \` \" \< \>``) are provided.
References
-==========
+----------
+
+An alternative, more complete set of short mnemonic character names is
+the `XML Entity Definitions for Characters`_ W3C Recommendation from
+01 April 2010.
+
+For glyph names of the LGR encoding see e.g. ``CB.enc`` by Apostolos
+Syropoulos and ``xl-lgr.enc`` from the libertine_ (legacy) package.
+``lgr.cmap`` provides a mapping to Unicode characters.
+
+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/doc/fntguide.pdf
@@ -153,6 +330,14 @@ References
.. _Docutils: http://docutils.sourceforge.net/rst.html
.. _TDS: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds
+.. _Adobe Glyph List For New Fonts:
+ http://www.adobe.com/devnet-archive/opentype/archives/aglfn.txt
+.. _Adobe Glyph List:
+ http://partners.adobe.com/public/developer/en/opentype/glyphlist.txt
+.. _Unicode names list: http://www.unicode.org/Public/UNIDATA/NamesList.txt
+.. _XML Entity Definitions for Characters:
+ http://www.w3.org/TR/xml-entity-names/
+
.. _CB Fonts: http://www.ctan.org/pkg/cbgreek-complete
.. _GFS font collection: http://www.ctan.org/pkg/gfs
.. _Kerkis: http://www.ctan.org/pkg/kerkis
@@ -163,4 +348,7 @@ References
.. _ibycus-babel: http://www.ctan.org/pkg/ibycus-babel
.. _ibygrk: http://www.ctan.org/pkg/ibygrk
.. _lgrx: http://www.ctan.org/pkg/lgrx
+.. _libertine: http://www.ctan.org/pkg/libertine-legacy
.. _substitutefont: http://www.ctan.org/pkg/substitutefont
+.. _ucs: http://www.ctan.org/pkg/unicode
+