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