diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/lgrx/README.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/lgrx/README.html | 400 |
1 files changed, 253 insertions, 147 deletions
diff --git a/Master/texmf-dist/doc/latex/lgrx/README.html b/Master/texmf-dist/doc/latex/lgrx/README.html index f4c821ce6b8..38dd3d0d176 100644 --- a/Master/texmf-dist/doc/latex/lgrx/README.html +++ b/Master/texmf-dist/doc/latex/lgrx/README.html @@ -10,7 +10,7 @@ /* :Author: David Goodger (goodger@python.org) -:Id: $Id: html4css1.css 7056 2011-06-17 10:50:48Z milde $ +:Id: $Id: html4css1.css 7434 2012-05-11 21:06:27Z milde $ :Copyright: This stylesheet has been placed in the public domain. Default cascading style sheet for the HTML output of Docutils. @@ -250,10 +250,18 @@ pre.address { margin-top: 0 ; font: inherit } -pre.literal-block, pre.doctest-block, pre.math { +pre.literal-block, pre.doctest-block, pre.math, pre.code { margin-left: 2em ; margin-right: 2em } +pre.code .ln { /* line numbers */ + color: grey; +} + +.code { + background-color: #eeeeee +} + span.classifier { font-family: sans-serif ; font-style: oblique } @@ -504,9 +512,10 @@ resulting list resembles the list-style 'outside' with a hanging indent. */ /* New ordered list: reset counter, suppress the default label */ -ol { +ol, ol.arabic, ol.loweralpha, ol.upperalpha, +ol.lowerroman, ol.upperroman { counter-reset: item; - list-style-type: none ! important; + list-style: none } /* Set the negative indent of the list label as feature of the list item */ @@ -568,6 +577,7 @@ ol.nested > li:before, ol.nested ol > li:before { dd > ul, dd > ol { padding-left: 0pt; +} /* TODO: prefix, suffix? */ @@ -685,7 +695,7 @@ div.hint, div.important, div.note, div.tip, div.warning { </head> <body> <div class="document" id="greek-text-with-the-lgr-font-encoding"> -<h1 class="title">Greek text with the <cite>LGR</cite> font encoding</h1> +<h1 class="title">Greek text with the LGR font encoding</h1> <dl class="docinfo simple"> <dt class="copyright">Copyright</dt> @@ -698,70 +708,167 @@ version 1.3 of this license or any later version.</p> </dl> <div class="abstract topic"> <p class="topic-title first">Abstract</p> -<p>The LGRx bundle provides packages and definitions for typesetting -Greek text with fonts in the LGR encoding, the de-facto standard -set by babel. It includes a comprehensive font definition file, -support for Unicode input and macros for Greek letters in -non-Greek text.</p> +<p>The LGR font encoding is the de-facto standard for Greek +typesetting with (8-bit) LaTeX. However, the encoding definition +file that ships with <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/babel.html">babel</a> misses many of the definitions common +since the advent of the NFSS <a class="citation-reference" href="#fntguide" id="id1">[fntguide]</a>.</p> +<p>The <cite>lgrx</cite> 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 +<cite>babel</cite> package.</p> +<p>The bundle is available from <a class="reference external" href="http://www.ctan.org/tex-archive/macros/latex/contrib/lgrx">CTAN</a> and included in TeXLive +2012. Development takes place at the <a class="reference external" href="http://milde.users.sourceforge.net/LGR/">Sourceforge</a>.</p> </div> <!-- -*- rst-mode -*- --> +<div class="note"> +<p class="admonition-title">Note</p> +<p>The TeXLive 2012 pre-release contains the Unicode definition file +<tt class="literal">lgrenc.dfu</tt> in the documentation instead of the TEXPATH. To enable +<a class="reference internal" href="#greek-unicode-support">Greek Unicode support</a>, update via <cite>tlmgr</cite> or place a copy in the +TEXPATH «by hand». +See <a class="reference external" href="http://tug.org/pipermail/tex-live/2012-June/031757.html">http://tug.org/pipermail/tex-live/2012-June/031757.html</a></p> +</div> <div class="contents topic" id="contents"> <p class="topic-title first">Contents</p> -<ul class="auto-toc simple"> -<li><p><a class="reference internal" href="#state-of-the-art" id="id8"><span class="sectnum">1</span> State of the Art</a></p></li> -<li><p><a class="reference internal" href="#problems" id="id9"><span class="sectnum">2</span> Problems</a></p></li> -<li><p><a class="reference internal" href="#lgrxenc-def-comprehensive-font-encoding-definitions" id="id10"><span class="sectnum">3</span> lgrxenc.def: Comprehensive font encoding definitions</a></p> +<ul class="simple"> +<li><p><a class="reference internal" href="#manifest" id="id15">Manifest</a></p></li> +<li><p><a class="reference internal" href="#motivation" id="id16">Motivation</a></p> <ul> -<li><p><a class="reference internal" href="#usage" id="id11">Usage</a></p></li> +<li><p><a class="reference internal" href="#greek-font-encodings" id="id17">Greek font encodings</a></p> +<ul> +<li><p><a class="reference internal" href="#unicode" id="id18">Unicode</a></p></li> +<li><p><a class="reference internal" href="#t7" id="id19">*T7</a></p></li> +<li><p><a class="reference internal" href="#lgr" id="id20">LGR</a></p></li> +<li><p><a class="reference internal" href="#ot7" id="id21">*OT7</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#lgrenc-dfu-greek-unicode-support" id="id12"><span class="sectnum">4</span> lgrenc.dfu: Greek Unicode support</a></p> +<li><p><a class="reference internal" href="#problems-with-the-default-setup" id="id22">Problems with the default setup</a></p></li> +</ul> +</li> +<li><p><a class="reference internal" href="#components-of-the-lgrx-bundle" id="id23">Components of the <cite>lgrx</cite> bundle</a></p> <ul> -<li><p><a class="reference internal" href="#id7" id="id13">Usage</a></p></li> +<li><p><a class="reference internal" href="#comprehensive-font-encoding-definition-file" id="id24">Comprehensive font encoding definition file</a></p></li> +<li><p><a class="reference internal" href="#greek-unicode-support" id="id25">Greek Unicode support</a></p></li> +<li><p><a class="reference internal" href="#macros-for-greek-in-text" id="id26">Macros for Greek in text</a></p></li> +<li><p><a class="reference internal" href="#generic-macros-for-greek-letters" id="id27">Generic macros for Greek letters</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#textalpha-sty-macros-for-greek-in-text" id="id14"><span class="sectnum">5</span> textalpha.sty: Macros for Greek in text</a></p></li> +<li><p><a class="reference internal" href="#references" id="id28">References</a></p></li> </ul> </div> -<div class="section" id="state-of-the-art"> -<h1><a class="toc-backref" href="#id8"><span class="sectnum">1</span> State of the Art</a></h1> -<p>Up to now, there is no agreement on a Greek standard font encoding -(reserved name <cite>T7</cite>) because the restrictions for general text encodings -are too severe for typesetting polytonic Greek.</p> -<p>The <cite>LGR</cite> font encoding is the de-facto standard for typesetting Greek with -(8-bit) LaTeX. Fonts in this encoding include the <a class="reference external" href="http://www.ctan.org/pkg/cbgreek-complete">CB fonts</a> (matching CM), -<a class="reference external" href="http://www.ctan.org/pkg/grtimes">grtimes</a> (Greek Times), <a class="reference external" href="http://www.ctan.org/pkg/kerkis">Kerkis</a> (matching URW Bookman), and the <a class="reference external" href="http://www.ctan.org/pkg/gfs">GFS font +<div class="section" id="manifest"> +<h1><a class="toc-backref" href="#id15">Manifest</a></h1> +<p>The lgrx bundle consists of the following LaTeX files:</p> +<dl class="docutils"> +<dt>LaTeX files:</dt> +<dd><dl class="field-list simple"> +<dt>lgrxenc.def</dt> +<dd><p>comprehensive LGR encoding definition file</p> +</dd> +<dt>lgrenc.dfu</dt> +<dd><p>support for Unicode input</p> +</dd> +<dt>textalpha.sty</dt> +<dd><p><tt class="literal"><span class="pre">\text...</span></tt> macros for Greek letters in non-Greek text</p> +</dd> +<dt>alphabeta.sty</dt> +<dd><p>Greek letters with <tt class="literal">\alpha</tt>, <tt class="literal">\beta</tt>, ... in text +and math</p> +</dd> +</dl> +<dl class="docutils"> +<dt>Literal sources:</dt> +<dd><p><a class="reference external" href="lgrxenc.def.html">lgrxenc.def.html</a>, <a class="reference external" href="lgrenc.dfu.html">lgrenc.dfu.html</a>, +<a class="reference external" href="textalpha.sty.html">textalpha.sty.html</a>, <a class="reference external" href="alphabeta.sty.html">alphabeta.sty.html</a></p> +</dd> +</dl> +</dd> +<dt>Documentation and test documents:</dt> +<dd><dl class="run-in field-list simple"> +<dt><a class="reference external" href="lgrx.pdf">lgrx.pdf</a></dt> +<dd><p>user documentation, source <a class="reference external" href="lgrx.tex">lgrx.tex</a></p> +</dd> +<dt><a class="reference external" href="greekhyperref.pdf">greekhyperref.pdf</a></dt> +<dd><p><cite>Greek script in PDF metadata</cite>, +source <a class="reference external" href="greekhyperref.tex">greekhyperref.tex</a></p> +</dd> +<dt><a class="reference external" href="greek-unicode.pdf">greek-unicode.pdf</a></dt> +<dd><p><cite>Greek Unicode with lgrenc.dfu</cite>, +source <a class="reference external" href="greek-unicode.tex">greek-unicode.tex</a></p> +</dd> +<dt><a class="reference external" href="lgrxenc-test.pdf">lgrxenc-test.pdf</a></dt> +<dd><p>source <a class="reference external" href="lgrxenc-test.tex">lgrxenc-test.tex</a></p> +</dd> +<dt><a class="reference external" href="textalpha-test.pdf">textalpha-test.pdf</a></dt> +<dd><p>source <a class="reference external" href="textalpha-test.tex">textalpha-test.tex</a></p> +</dd> +<dt><a class="reference external" href="alphabeta-test.pdf">alphabeta-test.pdf</a></dt> +<dd><p>source <a class="reference external" href="alphabeta-test.tex">alphabeta-test.tex</a></p> +</dd> +</dl> +</dd> +</dl> +</div> +<div class="section" id="motivation"> +<h1><a class="toc-backref" href="#id16">Motivation</a></h1> +<div class="section" id="greek-font-encodings"> +<h2><a class="toc-backref" href="#id17">Greek font encodings</a></h2> +<div class="section" id="unicode"> +<h3><a class="toc-backref" href="#id18">Unicode</a></h3> +<p>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 <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fontspec.html">fontspec</a>. Beware, that you must not use the <tt class="literal">greek</tt> or +<tt class="literal">polutonikogreek</tt> options of the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/babel.html">babel</a> package. The <cite>babel</cite> replacement +<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/polyglossia.html">polyglossia</a> provides Greek language support for XeLaTeX/LuaLaTeX. +If you go this way, you don't need the lgrx bundle.</p> +</div> +<div class="section" id="t7"> +<h3><a class="toc-backref" href="#id19">*T7</a></h3> +<p>The <a class="citation-reference" href="#encguide" id="id4">[encguide]</a> reserves the name T7 for a Greek <cite>standard font encoding</cite>. +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.</p> +</div> +<div class="section" id="lgr"> +<h3><a class="toc-backref" href="#id20">LGR</a></h3> +<p>The LGR font encoding is the de-facto standard for typesetting Greek with +(8-bit) LaTeX. Fonts in this encoding include the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/cbgreek-complete.html">CB fonts</a> (matching CM), +<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/grtimes.html">grtimes</a> (Greek Times), <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/kerkis.html">Kerkis</a> (matching URW Bookman), and the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/gfs.html">GFS font collection</a>. Setup of these fonts as Greek variant to matching Latin fonts -is facilitated by the <a class="reference external" href="http://www.ctan.org/pkg/substitutefont">substitutefont</a> package.</p> -<p>The <cite>LGR</cite> font encoding generates Greek characters via an ASCII +is facilitated by the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/substitutefont.html">substitutefont</a> package.</p> +<p>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 <a class="reference external" href="http://www.tug.org/texlive/Contents/live/texmf-dist/doc/generic/babel/greek-usage.pdf">greek-usage.pdf</a>, <a class="reference external" href="http://www.ctan.org/tex-archive/macros/latex/contrib/teubner/teubner-doc.pdf">teubner-doc.pdf</a>, or -<a class="reference external" href="http://www.eutypon.gr/eutypon/pdf/e2008-21/e21-a01.pdf">The CB Greek fonts</a>).</p> -<div class="compound"> -<p class="compound-first">The name <cite>LGR</cite> does not reflect status of this font encoding due to -historical reasons. The <a class="reference external" href="http://tug.ctan.org/tex-archive/macros/latex/doc/encguide.pdf">encguide</a> classifies encodings starting with <cite>L</cite> -as "local". Indeed, <cite>LGR</cite> started as a local encoding for the <cite>CB Greek -fonts</cite> by Claudio Beccari. Later, Apostolos Syropoulos advanced it to the -default font encoding for the <a class="reference external" href="http://www.ctan.org/pkg/babel">Babel</a> package's <tt class="literal">greek</tt> option. The -correct name would be <tt class="literal">OT7</tt>:</p> -<ul class="compound-middle simple"> +font (see <a class="citation-reference" href="#greek-usage" id="id5">[greek-usage]</a>, <a class="citation-reference" href="#teubner-doc" id="id6">[teubner-doc]</a>, <a class="citation-reference" href="#cbfonts" id="id7">[cbfonts]</a>).</p> +</div> +<div class="section" id="ot7"> +<h3><a class="toc-backref" href="#id21">*OT7</a></h3> +<p>The name LGR does not reflect status of this font encoding due to historical +reasons. <a class="citation-reference" href="#encguide" id="id8">[encguide]</a> classifies encodings starting with <cite>L</cite> as "local". +Indeed, LGR started as a local encoding for the <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/cbgreek-complete.html">CB fonts</a> by Claudio +Beccari. Later, Apostolos Syropoulos advanced it to the default font +encoding for the <cite>babel</cite> package's <tt class="literal">greek</tt> option. A better name would be +OT7:</p> +<ul class="simple"> <li><p>It is an 'old' encoding.</p></li> -<li><p>It implements a Latin transscription for a non-Latin script like the -<tt class="literal">OT2</tt> encoding.</p></li> -<li><p>It is not confined to 128 bit but <tt class="literal">OT4</tt> shows that this is no +<li><p>It implements a Latin transcription for a non-Latin script like the +OT2 encoding.</p></li> +<li><p>It is not confined to 128 bit but OT4 shows that this is no absolute requirement for an <cite>OT</cite> encoding.</p></li> </ul> -<p class="compound-last">However, due to the fact that this font encoding has been used under its +<p>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.</p> </div> </div> -<div class="section" id="problems"> -<h1><a class="toc-backref" href="#id9"><span class="sectnum">2</span> Problems</a></h1> +<div class="section" id="problems-with-the-default-setup"> +<h2><a class="toc-backref" href="#id22">Problems with the default setup</a></h2> +<p>The <cite>lgrx</cite> budle adresses a set of problems with the LGR font encoding as +set up by <cite>babel</cite>:</p> <ol class="arabic"> -<li><p>Ligatures with prefix notation prevent kerning (see the examples -linked below or the <cite>LGR</cite> documentation linked above).</p></li> +<li><p>Ligatures with prefix notation prevent kerning (see the example document +<a class="reference external" href="lgrxenc-test.pdf">lgrxenc-test.pdf</a> and <a class="citation-reference" href="#teubner-doc" id="id9">[teubner-doc]</a>).</p></li> <li><p>Sub-optimal results with the standard accent macros:</p> <ul class="simple"> <li><p>no combined accents,</p></li> @@ -771,142 +878,141 @@ linked below or the <cite>LGR</cite> documentation linked above).</p></li> </li> <li><p>The tilde character <tt class="literal">~</tt> is used for a non-breaking space by default. Therefore the transliteration for the <em>perispomeni</em> accent is -not available without re-definition of this character.<a class="footnote-reference" href="#tildehack" id="id4"><sup>1</sup></a></p></li> -<li><p>The <tt class="literal">polutonikogreek</tt> <cite>Babel</cite> option redefines both, <tt class="literal">~</tt> and <tt class="literal">\~</tt> +not available without re-definition of this character.<a class="footnote-reference" href="#tildehack" id="id10"><sup>1</sup></a></p></li> +<li><p>The <tt class="literal">polutonikogreek</tt> <cite>babel</cite> option redefines both, <tt class="literal">~</tt> and <tt class="literal">\~</tt> 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 <em>niño</em> if the language -is set to polytonic Greek, even if <tt class="literal">\textlatin</tt> is used.<a class="footnote-reference" href="#poluhack" id="id5"><sup>2</sup></a></p></li> -<li><p>There is no Unicode support with <a class="reference external" href="http://www.ctan.org/pkg/inputenc">inputenc</a>'s <tt class="literal">utf8</tt> option.</p> -<p>The <cite>ucs</cite> package contributed by Dominique Unruh provides Unicode -support with the <tt class="literal">utf8x</tt> option. A <a class="reference external" href="http://www.eutypon.gr/eutypon/pdf/e2008-20/e20-a03.pdf">babel patch</a> by Werner Lemberg -for Greek Unicode support never got applied.)</p> +is set to polytonic Greek, even if <tt class="literal">\textlatin</tt> is used.<a class="footnote-reference" href="#poluhack" id="id11"><sup>2</sup></a></p></li> +<li><p>There is no Unicode support with <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/inputenc.html">inputenc</a>'s <tt class="literal">utf8</tt> option.</p> +<p>The <cite>ucs</cite> package contributed by Dominique Unruh provides Unicode support +with the <tt class="literal">utf8x</tt> option. A babel patch by Werner Lemberg for Greek +Unicode support <a class="citation-reference" href="#lemberg2008" id="id12">[lemberg2008]</a> never got applied.)</p> </li> -<li><p>The LGR transliteration does not work for PDF bookmarks.</p></li> +<li><p>The LGR transliteration does not work for PDF metadata.</p></li> </ol> <dl class="footnote"><dt class="label">1</dt> <dd id="tildehack"> -<em>(<a class="fn-backref" href="#id4">1</a>, <a class="fn-backref" href="#id6">2</a>)</em> <p>Problem 3 can be solved by the simple one-liner</p> +<em>(<a class="fn-backref" href="#id10">1</a>, <a class="fn-backref" href="#id13">2</a>)</em> <p>Problem 3 can be solved by the simple one-liner</p> <pre class="literal-block">\DeclareTextSymbol{\~}{LGR}{126} </pre> <p>which results in <tt class="literal">\~</tt> inserting a plain tilde character if the -font encoding is <cite>LGR</cite>.</p> +font encoding is LGR.</p> <p class="last">Drawback: you cannot place a ~-accent on Greek characters except the ones supported by an input ligature.</p> </dd> -<dt class="label"><a class="fn-backref" href="#id5">2</a></dt> +<dt class="label"><a class="fn-backref" href="#id11">2</a></dt> <dd id="poluhack"> <p class="first">Fortunately, LaTeX saves copies of the accent macros: <tt class="literal">\~</tt> is an alias of <tt class="literal">\a~</tt> (which is an alias of <tt class="literal">\@tabacckludge~</tt>), so it -can be restored after loading <cite>Babel</cite> with:</p> +can be restored after loading <cite>babel</cite> with:</p> <pre class="literal-block">\addto\extraspolutonikogreek{\renewcommand*{\~}{\a~}} \addto\extrasgreek{\renewcommand*{\~}{\a~}} </pre> <p class="last">With this addition, both the comprehensive font encoding definitions and -the workaround<a class="footnote-reference" href="#tildehack" id="id6"><sup>1</sup></a> also work with the <tt class="literal">polutonikogreek</tt> -<cite>Babel</cite> option.</p> +the workaround<a class="footnote-reference" href="#tildehack" id="id13"><sup>1</sup></a> also work with the <tt class="literal">polutonikogreek</tt> +<cite>babel</cite> option.</p> </dd> </dl> </div> -<div class="section" id="lgrxenc-def-comprehensive-font-encoding-definitions"> -<h1><a class="toc-backref" href="#id10"><span class="sectnum">3</span> lgrxenc.def: Comprehensive font encoding definitions</a></h1> -<p><tt class="literal">lgrxenc.def</tt> is an alternative to the rudimentary <cite>LGR</cite> font -definition file <tt class="literal">lgrenc.def</tt> which comes with <a class="reference external" href="http://www.ctan.org/pkg/babel">Babel</a>'s Greek -support. It defines accent macros for the <cite>LGR</cite> font encoding 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 (<tt class="literal"><span class="pre">\~>a</span></tt>) or iteratively -(<tt class="literal"><span class="pre">\~\>{a}</span></tt>).</p> -<dl class="field-list simple"> -<dt>Source</dt> -<dd><p><a class="reference external" href="lgrxenc.def">lgrxenc.def</a>, <a class="reference external" href="lgrxenc.def.html">lgrxenc.def.html</a></p> -</dd> -<dt>Doc</dt> -<dd><p><a class="reference external" href="lgrxenc.tex">lgrxenc.tex</a>, <a class="reference external" href="lgrxenc.pdf">lgrxenc.pdf</a></p> -</dd> -<dt>Tests</dt> -<dd><p><a class="reference external" href="lgrxenc-test.tex">lgrxenc-test.tex</a>, <a class="reference external" href="lgrxenc-test.pdf">lgrxenc-test.pdf</a></p> -</dd> -</dl> -<div class="section" id="usage"> -<h2><a class="toc-backref" href="#id11">Usage</a></h2> -<p>To prevent confusion with <a class="reference external" href="http://www.ctan.org/pkg/babel">Babel</a>'s <tt class="literal">lgrenc.def</tt>, this file is named -<tt class="literal">lgrxenc.def</tt>. Load it by calling <a class="reference external" href="http://www.ctan.org/pkg/fontenc">fontenc</a> with the <tt class="literal">LGRx</tt> option.</p> -<dl class="docutils"> -<dt>Example:</dt> -<dd><p>Select font encodings <cite>T1</cite> (as default) and <cite>LGR</cite> (with the comprehensive -font encoding definitions)</p> -<blockquote> -<p><tt class="literal"><span class="pre">\usepackage[LGRx,T1]{fontenc}</span></tt></p> -</blockquote> +</div> +<div class="section" id="components-of-the-lgrx-bundle"> +<h1><a class="toc-backref" href="#id23">Components of the <cite>lgrx</cite> bundle</a></h1> +<p>The <cite>lgrx</cite> bundle comprises tools that help typesetting Greek script +with (8-bit) LaTeX in Greek as well as multi-lingual documents.</p> +<div class="section" id="comprehensive-font-encoding-definition-file"> +<h2><a class="toc-backref" href="#id24">Comprehensive font encoding definition file</a></h2> +<p><tt class="literal">lgrxenc.def</tt> is an alternative to the rudimentary LGR encoding +definition file<a class="footnote-reference" href="#fdf" id="id14"><sup>3</sup></a> <tt class="literal">lgrenc.def</tt> which comes with <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/babel.html">babel</a>'s Greek +support. It defines macros for Greek characters the LGR font encoding 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 (<tt class="literal"><span class="pre">\~>a</span></tt>) or iteratively (<tt class="literal"><span class="pre">\~\>{a}</span></tt>).</p> +<p>For usage and documentation see the literal source <a class="reference external" href="lgrxenc.def.html">lgrxenc.def.html</a>, the +user manual <a class="reference external" href="lgrx.pdf">lgrx.pdf</a>, and the test document <a class="reference external" href="lgrxenc-test.pdf">lgrxenc-test.pdf</a>.</p> +<dl class="footnote"><dt class="label"><a class="fn-backref" href="#id14">3</a></dt> +<dd id="fdf"> +<p class="first last">See [<a class="reference internal" href="#fntguide">fntguide</a>, section 5] for a definition of <cite>encoding definition +files</cite>.</p> </dd> </dl> -<div class="attention"> -<p class="admonition-title">Attention!</p> -<p>The name of the font encoding defined by the option <tt class="literal">LGRx</tt> -is <strong>not</strong> <cite>LGRx</cite> but <cite>LGR</cite>. Therefore, <tt class="literal">LGRx</tt> may not be the -last option (as fontenc uses the last option to select the default font -encoding). To set <cite>LGR</cite> as as default font encoding specify both, -<cite>LGRx</cite> and <cite>LGR</cite>, e.g.</p> -<blockquote> -<p><tt class="literal"><span class="pre">\usepackage[LGRx,T1,LGR]{fontenc}</span></tt></p> -</blockquote> </div> +<div class="section" id="greek-unicode-support"> +<h2><a class="toc-backref" href="#id25">Greek Unicode support</a></h2> +<p><tt class="literal">lgrenc.dfu</tt> provides standards-compatible UTF-8 support for Greek based +on the comprehensive font encoding definitions. It is compatible with +<a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/hyperref.html">hyperref</a> enabling Greek characters in PDF metadata without the need for +<tt class="literal">\texorpdfstring</tt>.</p> +<p>See the literal source <a class="reference external" href="lgrenc.dfu.html">lgrenc.dfu.html</a> and the test document +<a class="reference external" href="greek-unicode.pdf">greek-unicode.pdf</a>.</p> +</div> +<div class="section" id="macros-for-greek-in-text"> +<h2><a class="toc-backref" href="#id26">Macros for Greek in text</a></h2> +<p><tt class="literal">textalpha.sty</tt> defines <tt class="literal">\textalpha</tt>, <tt class="literal">\textbeta</tt> ... macros for Greek +letters in text that work in any font encoding and alias macros for +compatibility with existing packages. With this package, Unicode input of +Greek letters works in any font encoding, too.</p> +<p id="limitations">However, in any font encoding except LGR:</p> +<ul class="simple"> +<li><p>there is no kerning between Greek characters,</p></li> +<li><p>composition of diacritics (like <tt class="literal">\Dasia\Tonos</tt>) fails,</p></li> +<li><p>accent macros do not select precomposed characters +(pre-composed Unicode literals work fine).</p></li> +</ul> +<p>See the literal source <a class="reference external" href="textalpha.sty.html">textalpha.sty.html</a> and <a class="reference external" href="textalpha-test.pdf">textalpha-test.pdf</a> for +details on usage, limitations, and recommended workarounds.</p> +</div> +<div class="section" id="generic-macros-for-greek-letters"> +<h2><a class="toc-backref" href="#id27">Generic macros for Greek letters</a></h2> +<p><tt class="literal">alphabeta.sty</tt> allows you to use <tt class="literal">\alpha</tt>, <tt class="literal">\beta</tt>, ... in both, text +and math. For this, the math macros are redefined with the help of +<tt class="literal">\TextOrMath</tt> from the standard package <a class="reference external" href="http://mirror.ctan.org/help/Catalogue/entries/fixltx2e.html">fixltx2e</a>.</p> +<p>See the literal source <a class="reference external" href="alphabeta.sty.html">alphabeta.sty.html</a> and the test document +<a class="reference external" href="alphabeta-test.pdf">alphabeta-test.pdf</a>.</p> </div> </div> -<div class="section" id="lgrenc-dfu-greek-unicode-support"> -<h1><a class="toc-backref" href="#id12"><span class="sectnum">4</span> lgrenc.dfu: Greek Unicode support</a></h1> -<p>Standards-compatible UTF-8 support for Greek based on the comprehensive -font encoding definitions.</p> -<p>Cooperates with <a class="reference external" href="http://www.ctan.org/pkg/hyperref">hyperref</a> to enable Greek characters in section headers and -PDF bookmarks without the need for <tt class="literal">\texorpdfstring</tt>.</p> -<dl class="field-list simple"> -<dt>Source</dt> -<dd><p><a class="reference external" href="lgrenc.dfu">lgrenc.dfu</a>, <a class="reference external" href="lgrenc.dfu.html">lgrenc.dfu.html</a></p> +<div class="section" id="references"> +<h1><a class="toc-backref" href="#id28">References</a></h1> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id1">[fntguide]</a></dt> +<dd id="fntguide"> +<p class="first last">LaTeX3 Project Team, <cite>LaTeX 2ε font selection</cite>, 2005. +<a class="reference external" href="http://mirror.ctan.org/macros/latex/doc/fntguide.pdf">http://mirror.ctan.org/macros/latex/doc/fntguide.pdf</a></p> </dd> -<dt>Example</dt> -<dd><p><a class="reference external" href="greek-unicode.tex">greek-unicode.tex</a>, <a class="reference external" href="greek-unicode.pdf">greek-unicode.pdf</a></p> +</dl> +<dl class="citation"><dt class="label">[encguide]</dt> +<dd id="encguide"> +<em>(<a class="fn-backref" href="#id4">1</a>, <a class="fn-backref" href="#id8">2</a>)</em> <p class="last">Frank Mittelbach, Robin Fairbairns, Werner Lemberg, +LaTeX3 Project Team, <cite>LaTeX font encodings</cite>, 2006. +<a class="reference external" href="http://mirror.ctan.org/macros/latex/doc/encguide.pdf">http://mirror.ctan.org/macros/latex/doc/encguide.pdf</a></p> </dd> </dl> -<div class="section" id="id7"> -<h2><a class="toc-backref" href="#id13">Usage</a></h2> -<p>Requires comprehensive font encoding definitions from <tt class="literal">lgrxenc.def</tt>:</p> -<blockquote> -<p><tt class="literal"><span class="pre">\usepackage[LGRx,T1]{fontenc}</span></tt> % define LGR and T1 encodings -<tt class="literal"><span class="pre">\usepackage[utf8]{inputenc}</span></tt> % standard UTF-8 input encoding</p> -</blockquote> -<p>Unless combined with the <a class="reference internal" href="#textalpha">textalpha</a> package, text containing Greek Unicode -characters must be marked as requiring the LGR font encoding (either -directly or by setting the language to <tt class="literal">greek</tt> or <tt class="literal">polutonikogreek</tt>). -This is a feature of <a class="reference external" href="http://www.ctan.org/pkg/inputenc">inputenc</a>'s standard utf8 support, similar to the -behaviour for, e.g., Cyrillic characters.</p> -</div> -</div> -<div class="section" id="textalpha-sty-macros-for-greek-in-text"> -<span id="textalpha"></span><h1><a class="toc-backref" href="#id14"><span class="sectnum">5</span> textalpha.sty: Macros for Greek in text</a></h1> -<p>Macros for Greek letters in text that work in any font encoding (see the -example below for limitations) and alias macros for compatibility with -existing packages.</p> -<p>Cooperates with <a class="reference external" href="http://www.ctan.org/pkg/hyperref">hyperref</a> and <a class="reference external" href="http://www.ctan.org/pkg/bookmark">bookmark</a> to enable Greek characters in -section headers and PDF bookmarks without the need for <tt class="literal">\texorpdfstring</tt>.</p> -<div class="note"> -<p class="admonition-title">Note</p> -<p>The package was renamed from <cite>textgreek</cite> to <cite>textalpha</cite> to prevent -confusion with the <a class="reference external" href="http://www.ctan.org/pkg/textgreek">textgreek</a> package by Leonard Michlmayr.</p> -</div> -<dl class="field-list simple"> -<dt>Source</dt> -<dd><p><a class="reference external" href="textalpha.sty">textalpha.sty</a>, <a class="reference external" href="textalpha.sty.html">textalpha.sty.html</a></p> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id5">[greek-usage]</a></dt> +<dd id="greek-usage"> +<p class="first last">Apostolos Syropoulos, <cite>Writing Greek with the greek option +of the babel package</cite>, 1997. +<a class="reference external" href="http://www.tug.org/texlive/Contents/live/texmf-dist/doc/generic/babel/greek-usage.pdf">http://www.tug.org/texlive/Contents/live/texmf-dist/doc/generic/babel/greek-usage.pdf</a></p> </dd> -<dt>Example</dt> -<dd><p><a class="reference external" href="textalpha-test.tex">textalpha-test.tex</a>, <a class="reference external" href="textalpha-test.pdf">textalpha-test.pdf</a></p> +</dl> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id7">[cbfonts]</a></dt> +<dd id="cbfonts"> +<p class="first last">Claudio Beccari, <cite>The CB Greek fonts</cite>, Εὔτυπον, τεῦχος № 21, 2008. +<a class="reference external" href="http://www.eutypon.gr/eutypon/pdf/e2008-21/e21-a01.pdf">http://www.eutypon.gr/eutypon/pdf/e2008-21/e21-a01.pdf</a></p> </dd> -<dt>Bookmarks</dt> -<dd><p><a class="reference external" href="greekhyperref.tex">greekhyperref.tex</a>, <a class="reference external" href="greekhyperref.pdf">greekhyperref.pdf</a></p> +</dl> +<dl class="citation"><dt class="label">[teubner-doc]</dt> +<dd id="teubner-doc"> +<em>(<a class="fn-backref" href="#id6">1</a>, <a class="fn-backref" href="#id9">2</a>)</em> <p class="last">Claudio Beccari, <tt class="literal">teubner.sty</tt> +<cite>An extension to the greek option of the babel package</cite>, 2011. +<a class="reference external" href="http://mirror.ctan.org/macros/latex/contrib/teubner/teubner-doc.pdf">http://mirror.ctan.org/macros/latex/contrib/teubner/teubner-doc.pdf</a></p> +</dd> +</dl> +<dl class="citation"><dt class="label"><a class="fn-backref" href="#id12">[lemberg2008]</a></dt> +<dd id="lemberg2008"> +<p class="first last">Werner Lemberg, +<cite>Unicode support for the Greek LGR encoding</cite>, Εὔτυπον, τεῦχος № 20, 2008. +<a class="reference external" href="http://www.eutypon.gr/eutypon/pdf/e2008-20/e20-a03.pdf">http://www.eutypon.gr/eutypon/pdf/e2008-20/e20-a03.pdf</a></p> </dd> </dl> -<!-- References -========== --> </div> </div> </body> |