File: textalpha.sty.html

package info (click to toggle)
texlive-lang 2016.20170123-5
links: PTS
area: main
in suites: stretch
size: 1,093,148 kB
ctags: 15,901
sloc: perl: 46,074; xml: 29,603; makefile: 5,248; sh: 3,179; python: 2,949; ansic: 2,846; ruby: 945; lisp: 726; awk: 636; java: 159; sed: 142; cpp: 12
file content (1065 lines) | stat: -rw-r--r-- 43,739 bytes
parent folder | download | duplicates (2)
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.13: http://docutils.sourceforge.net/" />
<title>textalpha.sty</title>
<style type="text/css">

/* Minimal style sheet for the HTML output of Docutils.                    */
/*                                                                         */
/* :Author: Günter Milde, based on html4css1.css by David Goodger          */
/* :Id: $Id: minimal.css 7916 2015-09-11 15:20:14Z milde $               */
/* :Copyright: © 2015 Günter Milde.                                        */
/* :License: Released under the terms of the `2-Clause BSD license`_,      */
/*    in short:                                                            */
/*                                                                         */
/*    Copying and distribution of this file, with or without modification, */
/*    are permitted in any medium without royalty provided the copyright   */
/*    notice and this notice are preserved.                                */
/*                                                                         */
/*    This file is offered as-is, without any warranty.                    */
/*                                                                         */
/* .. _2-Clause BSD license: http://www.spdx.org/licenses/BSD-2-Clause     */

/* This CSS2.1_ stylesheet defines rules for Docutils elements without    */
/* HTML equivalent. It is required to make the document semantic visible. */
/*                                                                        */
/* .. _CSS2.1: http://www.w3.org/TR/CSS2                                  */
/* .. _validates: http://jigsaw.w3.org/css-validator/validator$link       */

/* Figure/table alignment */
.align-left  { text-align: left; }
.align-right { text-align: right; }
.align-center { clear: both; text-align: center;}

/* titles */
h1.title, p.subtitle {
  text-align: center;
}
p.admonition-title,
p.topic-title,
p.sidebar-title,
p.rubric,
p.system-message-title {
  font-weight: bold;
}
h1 + p.subtitle,
h1 + p.section-subtitle {
  font-size: 1.6em;
}
h2 + p.section-subtitle { font-size: 1.28em; }
p.subtitle,
p.section-subtitle,
p.sidebar-subtitle {
  font-weight: bold;
  margin-top: -0.5em;
}
p.sidebar-title,
p.rubric {
  font-size: larger;
}
p.rubric { color: maroon; }
a.toc-backref {
  color: black;
  text-decoration: none; }

/* Warnings, Errors */
div.caution p.admonition-title,
div.attention p.admonition-title,
div.danger p.admonition-title,
div.error p.admonition-title,
div.warning p.admonition-title,
div.system-messages h1,
div.error,
span.problematic,
p.system-message-title {
  color: red;
}

/* inline literals */
span.docutils.literal {
  font-family: monospace;
  white-space: pre-wrap;
}
/* do not wraph at hyphens and similar: */
.literal > span.pre { white-space: nowrap; }

/* Lists */

/* compact and simple lists: no margin between items */
.simple  li, .compact li,
.simple  ul, .compact ul,
.simple  ol, .compact ol,
.simple > li p, .compact > li p,
dl.simple > dd, dl.compact > dd {
  margin-top: 0;
  margin-bottom: 0;
}

/* Table of Contents */
div.topic.contents { margin: 0; }
ul.auto-toc {
  list-style-type: none;
  padding-left: 1.5em; }

/* Enumerated Lists */
ol.arabic     { list-style: decimal }
ol.loweralpha { list-style: lower-alpha }
ol.upperalpha { list-style: upper-alpha }
ol.lowerroman { list-style: lower-roman }
ol.upperroman { list-style: upper-roman }

dt span.classifier { font-style: italic }
dt span.classifier:before {
  font-style: normal;
  margin: 0.5em;
  content: ":";
}

/* Field Lists and drivatives */
/* bold field name, content starts on the same line */
dl.field-list > dt,
dl.option-list > dt,
dl.docinfo > dt,
dl.footnote > dt,
dl.citation > dt {
  font-weight: bold;
  clear: left;
  float: left;
  margin: 0;
  padding: 0;
  padding-right: 0.5em;
}
/* Offset for field content (corresponds to the --field-name-limit option) */
dl.field-list > dd,
dl.option-list > dd,
dl.docinfo > dd {
  margin-left:  9em; /* ca. 14 chars in the test examples */
}
/* start field-body on a new line after long field names */
dl.field-list > dd > *:first-child,
dl.option-list > dd > *:first-child
{
  display: inline-block;
  width: 100%;
  margin: 0;
}
/* field names followed by a colon */
dl.field-list > dt:after,
dl.docinfo > dt:after {
  content: ":";
}

/* Bibliographic Fields (docinfo) */
pre.address { font: inherit; }
dd.authors > p { margin: 0; }

/* Option Lists */
dl.option-list { margin-left: 40px; }
dl.option-list > dt { font-weight: normal; }
span.option { white-space: nowrap; }

/* Footnotes and Citations  */
dl.footnote.superscript > dd {margin-left: 1em; }
dl.footnote.brackets > dd {margin-left: 2em; }
dl > dt.label { font-weight: normal; }
a.footnote-reference.brackets:before,
dt.label > span.brackets:before { content: "["; }
a.footnote-reference.brackets:after,
dt.label > span.brackets:after { content: "]"; }
a.footnote-reference.superscript,
dl.footnote.superscript > dt.label {
  vertical-align: super;
  font-size: smaller;
}
dt.label > span.fn-backref { margin-left: 0.2em; }
dt.label > span.fn-backref > a { font-style: italic; }

/* Line Blocks */
div.line-block { display: block; }
div.line-block div.line-block {
  margin-top: 0;
  margin-bottom: 0;
  margin-left: 40px;
}

/* Images and Figures */
img.align-left,
.figure.align-left,
object.align-left {
  display: block;
  margin-right: auto;
}
img.align-center,
.figure.align-center,
object.align-center {
  display: block;
  margin-left: auto;
  margin-right: auto;
}
img.align-right,
.figure.align-right,
object.align-right {
  display: block;
  margin-left: auto;
}
/* reset inner alignment in figures */
div.align-right { text-align: inherit }

/* Admonitions and System Messages */
div.admonition,
div.system-message,
div.sidebar{
  margin: 40px;
  border: medium outset;
  padding-right: 1em;
  padding-left: 1em;
}

/* Sidebar */
div.sidebar {
  width: 30%;
  max-width: 26em;
  float: right;
  clear: right;
}

/* Text Blocks */
div.topic,
pre.literal-block,
pre.doctest-block,
pre.math,
pre.code {
  margin-right: 40px;
  margin-left: 40px;
}
pre.code .ln { color: gray; } /* line numbers */

/* Tables */
table { border-collapse: collapse; }
td, th {
  border-style: solid;
  border-color: silver;
  padding: 0 1ex;
  border-width: thin;
}
td > p:first-child, th > p:first-child { margin-top: 0; }
td > p, th > p { margin-bottom: 0; }

table > caption {
  text-align: left;
  margin-bottom: 0.25em
}

table.borderless td, table.borderless th {
  border: 0;
  padding: 0;
  padding-right: 0.5em /* separate table cells */
}

</style>
<style type="text/css">

/* CSS31_ style sheet for the output of Docutils HTML writers.             */
/* Rules for easy reading and pre-defined style variants.		   */
/*                                                                         */
/* :Author: Günter Milde, based on html4css1.css by David Goodger          */
/* :Id: $Id: plain.css 7893 2015-05-11 15:38:58Z milde $               */
/* :Copyright: © 2015 Günter Milde.                                        */
/* :License: Released under the terms of the `2-Clause BSD license`_,      */
/*    in short:                                                            */
/*                                                                         */
/*    Copying and distribution of this file, with or without modification, */
/*    are permitted in any medium without royalty provided the copyright   */
/*    notice and this notice are preserved.                                */
/*    	     	      	     	 					   */
/*    This file is offered as-is, without any warranty.                    */
/*                                                                         */
/* .. _2-Clause BSD license: http://www.spdx.org/licenses/BSD-2-Clause     */
/* .. _CSS3: http://www.w3.org/TR/CSS3		        		   */


/* Document Structure */
/* ****************** */

/* "page layout" */
body {
  padding: 0 5%;
  margin: 8px 0;
}
div.document {
  line-height:1.3;
  counter-reset: table;
  /* counter-reset: figure; */
  /* avoid long lines --> better reading */
  /* OTOH: lines should not be too short because of missing hyphenation, */
  max-width: 50em;
  margin: auto;
}

/* Sections */

/* Transitions */

hr.docutils {
  width: 80%;
  margin-top: 1em;
  margin-bottom: 1em;
  clear: both;
}

/* Paragraphs               */
/* ==========               */

/* vertical space (parskip) */
p, ol, ul, dl,
div.line-block,
table{
  margin-top: 0.5em;
  margin-bottom: 0.5em;
}
h1, h2, h3, h4, h5, h6,
dl > dd {
  margin-bottom: 0.5em;
}

/* Lists                    */
/* ==========               */

/* Definition Lists         */

dl > dd p:first-child { margin-top: 0; }
/* :last-child is not part of CSS 2.1 (introduced in CSS 3) */
/* dl > dd p:last-child  { margin-bottom: 0; } */

/* lists nested in definition lists */
/* :only-child is not part of CSS 2.1 (introduced in CSS 3) */
dd > ul:only-child, dd > ol:only-child { padding-left: 1em; }

/* Description Lists */
/* styled like in most dictionaries, encyclopedias etc. */
dl.description > dt {
  font-weight: bold;
  clear: left;
  float: left;
  margin: 0;
  padding: 0;
  padding-right: 0.5em;
}

/* Field Lists */

/* example for custom field-name width */
dl.field-list.narrow > dd {
  margin-left: 5em;
}
/* run-in: start field-body on same line after long field names */
dl.field-list.run-in > dd p {
  display: block;
}

/* Bibliographic Fields */

/* generally, bibliographic fields use special definition list dl.docinfo */
/* but dedication and abstract are placed into "topic" divs */
div.abstract p.topic-title {
  text-align: center;
}
div.dedication {
  margin: 2em 5em;
  text-align: center;
  font-style: italic;
}
div.dedication p.topic-title {
  font-style: normal;
}

/* Citations */
dl.citation dt.label {
  font-weight: bold;
}
span.fn-backref {
  font-weight: normal;
}

/* Text Blocks           */
/* ============          */

/* Literal Blocks           */
pre.literal-block, pre.doctest-block,
pre.math, pre.code {
  margin-left: 1.5em;
  margin-right: 1.5em
}

/* Block Quotes             */

blockquote,
div.topic {
  margin-left: 1.5em;
  margin-right: 1.5em
}
blockquote > table,
div.topic > table {
  margin-top: 0;
  margin-bottom: 0;
}
blockquote p.attribution,
div.topic p.attribution {
  text-align: right;
  margin-left: 20%;
}

/* Tables                   */
/* ======                   */

/* th { vertical-align: bottom; } */

/* "booktabs" style (no vertical lines) */
table.booktabs {
  border: 0;
  border-top: 2px solid;
  border-bottom: 2px solid;
  border-collapse: collapse;
}
table.booktabs * {
  border: 0;
}
table.booktabs th {
  border-bottom: thin solid;
  text-align: left;
}

/* numbered tables (counter defined in div.document) */
table.numbered > caption:before {
  counter-increment: table;
  content: "Table " counter(table) ": ";
  font-weight: bold;
}

/* Explicit Markup Blocks   */
/* ======================   */

/* Footnotes and Citations  */
/* -----------------------  */

/* line on the left */
dl.footnote {
  padding-left: 1ex;
  border-left: solid;
  border-left-width: thin;
}

/* Directives               */
/* ----------               */

/* Body Elements            */
/* ~~~~~~~~~~~~~            */

/* Images and Figures */
img.align-left,
.figure.align-left,
object.align-left {
  clear: left;
  float: left;
  margin-right: 1em
}
img.align-right,
.figure.align-right,
object.align-right {
  clear: right;
  float: right;
  margin-left: 1em
}
/* Stop floating sidebars, images and figures at section level 1,2,3 */
h1, h2, h3 { clear: both; }

/* Sidebar */

/* Move into the margin. In a layout with fixed margins, */
/* it can be moved into the margin completely.		 */
div.sidebar {
  width: 30%;
  max-width: 26em;
  margin-left: 1em;
  margin-right: -5.5%;
  background-color: #ffffee ;
}

/* Code                     */

pre.code, code { background-color: #eeeeee }
pre.code .ln { color: gray; } /* line numbers */
/* basic highlighting: for a complete scheme, see */
/* http://docutils.sourceforge.net/sandbox/stylesheets/ */
pre.code .comment, code .comment { color: #5C6576 }
pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
pre.code .literal.string, code .literal.string { color: #0C5404 }
pre.code .name.builtin, code .name.builtin { color: #352B84 }
pre.code .deleted, code .deleted { background-color: #DEB0A1}
pre.code .inserted, code .inserted { background-color: #A3D289}

/* Math                     */
/* styled separately (see math.css for math-output=HTML) */

/* Epigraph                 */
/* Highlights               */
/* Pull-Quote               */
/* Compound Paragraph       */
/* Container                */

/* can be styled in a custom stylesheet */

/* Document Header and Footer */

div.footer, div.header {
  clear: both;
  font-size: smaller;
}

/* Inline Markup            */
/* =============            */

/* Emphasis                 */
/*   em                     */
/* Strong Emphasis          */
/*   strong		    */
/* Interpreted Text         */
/*   span.interpreted  	    */
/* Title Reference 	    */
/*   cite		    */
/* Inline Literals          */
/* possible values: normal, nowrap, pre, pre-wrap, pre-line */
/*   span.docutils.literal { white-space: pre-wrap; } */

/* Hyperlink References     */
a { text-decoration: none; }

/* External Targets         */
/*   span.target.external   */
/* Internal Targets  	    */
/*   span.target.internal   */
/* Footnote References      */
/*   a.footnote-reference   */
/* Citation References      */
/*   a.citation-reference   */

</style>
</head>
<body>
<div class="document" id="textalpha-sty">
<h1 class="title">textalpha.sty</h1>

<p class="subtitle" id="greek-symbols-in-text">Greek symbols in text</p>
<dl class="docinfo">
<dt class="copyright">Copyright</dt>
<dd class="copyright">© 2010 Günter Milde</dd>
<dt class="licence">Licence</dt>
<dd class="licence"><p>This work may be distributed and/or modified under the
conditions of the <a class="reference external" href="http://www.latex-project.org/lppl.txt">LaTeX Project Public License</a>, either
version 1.3 of this license or any later version.</p>
</dd>
<dt class="identification">Identification</dt>
<dd class="identification"><pre class="literal-block">\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{textalpha}
[2016/02/05 v0.13.2 macros for Greek letters in text]</pre>
</dd>
</dl>
<div class="abstract topic">
<p class="topic-title first">Abstract</p>
<p>Provide a set of <span class="docutils literal">\text*</span> macros for Greek characters
in text mode.</p>
</div>
<div class="admonition 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>
<dt>Changelog:</dt>
<dd><table class="borderless">
<colgroup>
<col style="width: 8%" />
<col style="width: 14%" />
<col style="width: 78%" />
</colgroup>
<tbody>
<tr><td><p>0.1</p></td>
<td><p>2010-06-16</p></td>
<td><p>initial version</p></td>
</tr>
<tr><td><p>0.2</p></td>
<td><p>2012-06-27</p></td>
<td><p>support for compound Unicode definitions outside LGR</p></td>
</tr>
<tr><td><p>0.3</p></td>
<td><p>2013-05-03</p></td>
<td><p>new accent macro names with <span class="docutils literal">lgrxenc.def</span> 0.7</p></td>
</tr>
<tr><td><p>0.4</p></td>
<td><p>2013-05-28</p></td>
<td><p>use <span class="docutils literal">lgrenc.def</span> from greek-fontenc.</p></td>
</tr>
<tr><td><p>0.5</p></td>
<td><p>2013-09-11
..</p></td>
<td><p>move to <a class="reference external" href="http://www.ctan.org/pkg/greek-fontenc">greek-fontenc</a>,
support XeTeX/LuaTeX, add breve below accents.</p></td>
</tr>
<tr><td><p>0.11</p></td>
<td><p>2013-11-28</p></td>
<td><p>compatibility with Xe/LuaTeX in 8-bit mode.</p></td>
</tr>
<tr><td><p>0.12</p></td>
<td><p>2014-12-12</p></td>
<td><p>fix auxiliary macro names,
define symbol macros for breathing accents.</p></td>
</tr>
<tr><td><p>0.13</p></td>
<td><p>2015-09-04
..</p></td>
<td><p>Option <a class="reference internal" href="#normalize-symbols">normalize-symbols</a>: support for symbol variants.
Option <a class="reference internal" href="#keep-semicolon">keep-semicolon</a>: use semicolon as erotimatiko
in LGR.</p></td>
</tr>
<tr><td><p>0.13.2</p></td>
<td><p>2016-02-05</p></td>
<td><p>Support for standard Unicode text font encoding “TU”
(new in fontspec v2.5a).</p></td>
</tr>
</tbody>
</table>
</dd>
</dl>
<div class="contents topic" id="contents">
<p class="topic-title first">Contents</p>
<ul class="simple">
<li><p><a class="reference internal" href="#motivation" id="id1">Motivation</a></p></li>
<li><p><a class="reference internal" href="#usage" id="id2">Usage</a></p></li>
<li><p><a class="reference internal" href="#implementation" id="id3">Implementation</a></p>
<ul>
<li><p><a class="reference internal" href="#options" id="id4">Options</a></p>
<ul>
<li><p><a class="reference internal" href="#normalize-symbols" id="id5">normalize-symbols</a></p></li>
<li><p><a class="reference internal" href="#keep-semicolon" id="id6">keep-semicolon</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#font-encodings" id="id7">Font encodings</a></p></li>
<li><p><a class="reference internal" href="#symbol-macros-for-breathings" id="id8">Symbol macros for breathings</a></p></li>
<li><p><a class="reference internal" href="#default-declarations" id="id9">Default declarations</a></p>
<ul>
<li><p><a class="reference internal" href="#greekscript-ensuregreek" id="id10">greekscript, ensuregreek</a></p></li>
<li><p><a class="reference internal" href="#greek-alphabet" id="id11">Greek Alphabet</a></p></li>
<li><p><a class="reference internal" href="#additional-greek-symbols" id="id12">Additional Greek symbols</a></p>
<ul>
<li><p><a class="reference internal" href="#variant-shape-symbols" id="id13">variant shape symbols</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#diacritics" id="id14">Diacritics</a></p></li>
<li><p><a class="reference internal" href="#auxiliary-macros" id="id15">Auxiliary macros</a></p></li>
<li><p><a class="reference internal" href="#semicolon-as-erotimatiko" id="id16">semicolon as erotimatiko</a></p></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="motivation">
<h1><a class="toc-backref" href="#id1">Motivation</a></h1>
<p>By default, TeX macros for Greek letters are only valid in mathematical
mode. This package sets up a suitable <a class="reference internal" href="#font-encoding">font encoding</a> and <cite>LaTeX internal
character representations</cite> (LICR) definitions for Greek (<span class="docutils literal">\textalpha</span> –
<span class="docutils literal">\textOmega</span>).</p>
<p>To allow documents using Greek LICR macros without worrying about the TeX
engine used to compile them, this package tests the declared font encodings
and does “the right thing” to set up Greek text font support:</p>
<ul class="simple">
<li><p>If the Unicode font encodings EU1 (XeTeX) or EU2 (LuaTeX) are declared,
before loading this package (e.g. via <span class="docutils literal">fontspec</span>) the package provides
Greek LICR definitions for them.</p></li>
<li><p>Otherwise, the <a class="reference external" href="README.html#lgr">LGR font encoding</a> is set as <cite>default font encoding</cite>
(cf. <a class="reference external" href="http://mirror.ctan.org/macros/latex/doc/fntguide.pdf">fntguide</a> section 5.3) for Greek.</p></li>
</ul>
<p>Advantages:</p>
<ul class="simple">
<li><p>Symbols from a Greek text font (e.g. the <a class="reference external" href="http://www.ctan.org/pkg/cbgreek-complete">CB fonts</a>) can be accessed
without the need for an explicite font-encoding switch anywhere in the
text.</p></li>
<li><p>Unicode input of Greek characters is supported</p>
<ul>
<li><p>via <span class="docutils literal"><span class="pre">\usepackage[utf8]{inputenc}</span></span> and <span class="docutils literal">lgrenc.dfu</span> from
<a class="reference external" href="http://www.ctan.org/pkg/greek-inputenc">greek-inputenc</a> for 8-bit TeX or XeTeX/LuaTeX in 8-bit compatibility
mode in any font encoding (see <a class="reference external" href="textalpha-doc.tex">textalpha-doc.tex</a>).</p></li>
<li><p>natively by XeTeX/LuaTeX for Unicode fonts. As <a class="reference external" href="http://www.ctan.org/pkg/inputenc">inputenc</a> does not work
with these engines, text input can be done via the Latin transcription
or LICR but <em>not via literal Unicode characters</em> for 8-bit font encodings
like LGR (see <a class="reference external" href="greek-euenc-doc.tex">greek-euenc-doc.tex</a>).</p></li>
</ul>
</li>
</ul>
<div class="admonition attention">
<p class="admonition-title">Attention!</p>
<p>The macros work well in any font encoding for single symbols.
However, with 8-bit TeX engines, the automatic font-encoding switches
behind the doors interfere with kerning between letters and replacement
of accent+character with a pre-composed character.</p>
<p>Therefore, Greek text should be written with the help of <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a> or
<a class="reference external" href="http://www.ctan.org/pkg/polyglossia">polyglossia</a> (setting the language to <span class="docutils literal">greek</span>) or wrapped in the
provided <span class="docutils literal">ensuregreek</span> macro.  Using <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a> or <a class="reference external" href="http://www.ctan.org/pkg/polyglossia">polyglossia</a> also helps
to ensure correct hyphenation of Greek text.</p>
</div>
</div>
<div class="section" id="usage">
<h1><a class="toc-backref" href="#id2">Usage</a></h1>
<p>Ensure support for Greek characters in text mode with</p>
<pre class="code latex literal-block"><code><span class="keyword">\usepackage</span><span class="name builtin">{</span>textalpha<span class="name builtin">}</span></code></pre>
<p>eventually with the <a class="reference internal" href="#options">options</a> to normalize symbols variants</p>
<pre class="code latex literal-block"><code><span class="keyword">\usepackage</span><span class="name attribute">[normalize-symbols]</span><span class="name builtin">{</span>textalpha<span class="name builtin">}</span></code></pre>
<p>and/or to use the semicolon as <a class="reference external" href="https://en.wikipedia.org/wiki/Question_mark#Erotimatiko">erotimatiko</a> also in 8-bit TeX</p>
<pre class="code latex literal-block"><code><span class="keyword">\usepackage</span><span class="name attribute">[normalize-symbols,keep-semicolon]</span><span class="name builtin">{</span>textalpha<span class="name builtin">}</span></code></pre>
<p>To give <span class="docutils literal">textalpha.sty</span> a chance of finding out which <a class="reference internal" href="#font-encodings">font encodings</a>
are used, load it after <a class="reference external" href="http://www.ctan.org/pkg/fontspec">fontspec</a> and/or <a class="reference external" href="http://www.ctan.org/pkg/fontenc">fontenc</a>.</p>
<p>For detailled examples see <a class="reference external" href="textalpha-doc.tex">textalpha-doc.tex</a> and <a class="reference external" href="textalpha-doc.pdf">textalpha-doc.pdf</a>
(8-bit TeX and XeTeX/LuaTeX in 8-bit compatibility mode) as well as
<a class="reference external" href="greek-euenc-doc.tex">greek-euenc-doc.tex</a> and <a class="reference external" href="greek-euenc-doc.pdf">greek-euenc-doc.pdf</a> (XeTeX/LuaTeX with
Unicode fonts).</p>
<p>With XeTeX or LuaTex, Unicode fonts and LGR encoded 8-bit fonts can be used
in the same document (see <a class="reference external" href="greek-euenc-doc.tex">greek-euenc-doc.tex</a>).</p>
</div>
<div class="section" id="implementation">
<h1><a class="toc-backref" href="#id3">Implementation</a></h1>
<div class="section" id="options">
<h2><a class="toc-backref" href="#id4">Options</a></h2>
<div class="section" id="normalize-symbols">
<h3><a class="toc-backref" href="#id5">normalize-symbols</a></h3>
<p>The “variant shape” symbol characters like <span class="docutils literal">03D1 GREEK THETA SYMBOL</span> are
mathematical charcters for mathematical use
(similar to <span class="docutils literal">1D440 MATHEMATICAL ITALIC CAPITAL M</span>).
Unfortunately, some Greek texts sources in Unicode encoding mix letter and
symbol characters .</p>
<p>The “normalize-symbols” option controls the handling of <a class="reference internal" href="#variant-shape-symbols">variant shape
symbols</a> under 8-bit TeX:</p>
<ul class="simple">
<li><p>The option activates a simple “folding” mechanism that merges ϰ and κ to
textkappa etc. for text copied from external sources which may use the
GREEK SYMBOL characters in place of GREEK LETTERS,</p></li>
<li><p>Without this option, variant shape symbols in the input are reported as
errors to prevent information loss in cases where the distinction between
ϰ and κ is intended (e.g. in mathematical or scientific context).</p></li>
</ul>
<p>With XeTeX/LuaTeX and Unicode fonts, this option is ignored.</p>
<pre class="literal-block">\newif\iftextalpha&#64;normalizeSymbols
\DeclareOption{normalize-symbols}{\textalpha&#64;normalizeSymbolstrue}</pre>
</div>
<div class="section" id="keep-semicolon">
<h3><a class="toc-backref" href="#id6">keep-semicolon</a></h3>
<p>The <a class="reference external" href="https://en.wikipedia.org/wiki/Question_mark#Erotimatiko">erotimatiko</a> looks like a semicolon but is a
<strong>Greek question mark</strong>:</p>
<ul class="simple">
<li><p>The <a class="reference external" href="README.html#lgr">LGR font encoding</a> uses the Latin question mark as input for the
<cite>erotimatiko</cite> and maps the semicolon to a middle dot (<cite>ano teleia</cite>).</p></li>
<li><p>The Unicode standard provides the code point <span class="docutils literal">037E GREEK QUESTION MARK</span>
but says: “character <span class="docutils literal">003B SEMICOLON</span> (and not 037E) is the preferred
character for Greek question mark”.</p></li>
</ul>
<p>The <span class="docutils literal"><span class="pre">keep-semicolon</span></span> option allows to use the <a class="reference internal" href="#semicolon-as-erotimatiko">semicolon as erotimatiko</a>
in both, Xe/LuaTeX and 8-bit TeX. (The <cite>ano teleia</cite> can be input as
<span class="docutils literal">\textanoteleia</span> or using character <span class="docutils literal">00B7 MIDDLE DOT</span>.)
With XeTeX/LuaTeX and Unicode fonts, this option is ignored.</p>
<pre class="literal-block">\newif\iftextalpha&#64;keepSemicolon
\DeclareOption{keep-semicolon}{\textalpha&#64;keepSemicolontrue}

\ProcessOptions\relax</pre>
</div>
</div>
<div class="section" id="font-encodings">
<span id="font-encoding"></span><h2><a class="toc-backref" href="#id7">Font encodings</a></h2>
<p>With 8-bit LaTeX, the <a class="reference external" href="README.html#lgr">LGR font encoding</a> is used for Greek characters. If
no Greek-supporting font encoding (TU, EU1, EU2, or LGR) is declared, LGR is
loaded and set up as default Greek font encoding by this package.</p>
<p>With XeTeX or LuaTeX, there is one common input and font encoding –
Unicode. 8-bit TeX font encodings are only used in compatibility mode or for
fonts not available otherwise. For compatibility with the LaTeX font
selection system, <a class="reference external" href="http://www.ctan.org/pkg/fontspec">fontspec</a> defines the TU font encoding or the (pseudo)
font encodings EU1 and EU2 for XeTeX and LuaTeX respectively. However
<cite>fontspec</cite> does not (yet) define Greek LICR macros. We therefore explicitely
load Greek LICR definitions for XeTeX/LuaTeX from <a class="reference external" href="greek-euenc.def.html">greek-euenc.def</a> which in turn includes <a class="reference external" href="greek-fontenc.def.html">greek-fontenc.def</a>.</p>
<p>Ensure a Greek-supporting font encoding exists and supports Greek LICR
macros:</p>
<ul class="simple">
<li><p>Load the Greek LICR definitions for Unicode if the font encoding TU, EU1
(XeTeX) or EU2 (LuaTeX) is detected.</p></li>
<li><p>Re-set <span class="docutils literal">\LastDeclaredEncoding</span> (used in some included font-encoding files).</p></li>
<li><p>If none of TU, EU1, EU2, or LGR is declared, load <span class="docutils literal">lgrenc.def</span>.</p></li>
</ul>
<pre class="literal-block">\&#64;ifl&#64;aded{def}{tuenc}{
  \renewcommand{\LastDeclaredEncoding}{TU}
  \input{greek-euenc.def}
}{% else
  \&#64;ifl&#64;aded{def}{eu1enc}{
    \renewcommand{\LastDeclaredEncoding}{EU1}
    \input{greek-euenc.def}
  }{% else
    \&#64;ifl&#64;aded{def}{eu2enc}{
      \renewcommand{\LastDeclaredEncoding}{EU2}
      \input{greek-euenc.def}
    }{% else
      \&#64;ifl&#64;aded{def}{lgrenc}{
        % LGR already declared and set up
        \renewcommand{\LastDeclaredEncoding}{LGR}
      }{
        \input{lgrenc.def}
      }
    }
  }
}</pre>
<p>The package <a class="reference external" href="http://www.ctan.org/pkg/hyperref">hyperref</a> defines the PU font encoding which also supports
(monotonic) Greek. It currently misses polytonic greek and the
<span class="docutils literal">\greekscript</span> and <span class="docutils literal">\ensuregreek</span> TextCommands:</p>
<pre class="literal-block">\&#64;ifl&#64;aded{def}{puenc}
  {\ProvideTextCommand{\greekscript}{PU}{}
   \ProvideTextCommand{\ensuregreek}{PU}[1]{#1}}
  {}</pre>
</div>
<div class="section" id="symbol-macros-for-breathings">
<h2><a class="toc-backref" href="#id8">Symbol macros for breathings</a></h2>
<p>In the Latin transcription provided by LGR, breathing accents (Dasia and
Psili) are input as &lt; and &gt;. We provide the corresponding NFSS macro accents
(moved here from <a class="reference external" href="greek-fontenc.def.html">greek-fontenc.def</a>).</p>
<p>As Xe/LuaTeX may use LGR in combination with EU1 or EU2, we define the
macros twice, for LGR and Unicode font encodings (if they are defined):</p>
<pre class="literal-block">\&#64;ifl&#64;aded{def}{lgrenc}{
  \DeclareTextCommand{\&lt;}{LGR}{\accdasia}
  \DeclareTextCommand{\&gt;}{LGR}{\accpsili}
  % Composite accents starting with the new-defined shortcuts:
  \DeclareTextCompositeCommand{\&gt;}{LGR}{'}{\accpsilioxia}
  \DeclareTextCompositeCommand{\&gt;}{LGR}{`}{\accpsilivaria}
  \DeclareTextCompositeCommand{\&gt;}{LGR}{~}{\accpsiliperispomeni}
  \DeclareTextCompositeCommand{\&lt;}{LGR}{'}{\accdasiaoxia}
  \DeclareTextCompositeCommand{\&lt;}{LGR}{`}{\accdasiavaria}
  \DeclareTextCompositeCommand{\&lt;}{LGR}{~}{\accdasiaperispomeni}
}{}

\&#64;ifl&#64;aded{def}{greek-euenc}{ % XeTeX or LuaTeX with Unicode fonts
  \DeclareTextCommand{\&lt;}{\LastDeclaredEncoding}{\accdasia}
  \DeclareTextCommand{\&gt;}{\LastDeclaredEncoding}{\accpsili}
  % Composite accents starting with the new-defined shortcuts:
  \DeclareTextCompositeCommand{\&gt;}{\LastDeclaredEncoding}{'}{\accpsilioxia}
  \DeclareTextCompositeCommand{\&gt;}{\LastDeclaredEncoding}{`}{\accpsilivaria}
  \DeclareTextCompositeCommand{\&gt;}{\LastDeclaredEncoding}{~}{\accpsiliperispomeni}
  \DeclareTextCompositeCommand{\&lt;}{\LastDeclaredEncoding}{'}{\accdasiaoxia}
  \DeclareTextCompositeCommand{\&lt;}{\LastDeclaredEncoding}{`}{\accdasiavaria}
  \DeclareTextCompositeCommand{\&lt;}{\LastDeclaredEncoding}{~}{\accdasiaperispomeni}
}{}</pre>
</div>
<div class="section" id="default-declarations">
<h2><a class="toc-backref" href="#id9">Default declarations</a></h2>
<p>The following definitions ensure that the Greek LICR macros can be used
anywhere in the document also with 8-bit TeX by declaring LGR as their
default font encoding. Abort here, if the LGR font encoding is not defined:</p>
<pre class="literal-block">\&#64;ifl&#64;aded{def}{lgrenc}
  {}
% else return:
  {\expandafter\endinput}</pre>
<div class="section" id="greekscript-ensuregreek">
<h3><a class="toc-backref" href="#id10">greekscript, ensuregreek</a></h3>
<p>The <span class="docutils literal">\greekscript</span> declaration ensures the current font encoding supports
the Greek script. <span class="docutils literal"><span class="pre">greek-fontenc.def</span></span> sets this to the empty declaration
for font encodings that do so. This is currently used by <span class="docutils literal">lgrenc.def</span>
(LGR) and <span class="docutils literal"><span class="pre">greek-euenc.def</span></span> (Greek LICR macros for EU1 and EU2).</p>
<p>We define LGR as default encoding for Greek text. We use
<span class="docutils literal">\ProvideTextCommandDefault</span> to enable the author or other packages to use
an alternative definition (see [<a class="reference external" href="http://mirror.ctan.org/macros/latex/doc/fntguide.pdf">fntguide</a>]):</p>
<pre class="literal-block">\ProvideTextCommandDefault{\greekscript}{\fontencoding{LGR}\selectfont}</pre>
<p>The <span class="docutils literal">\ensuregreek</span> command can be used to ensure that its argument is set in
a font encoding with support for Greek. Again the default is LGR:</p>
<pre class="literal-block">\ProvideTextCommandDefault{\ensuregreek}[1]{\leavevmode{\greekscript #1}}</pre>
<!-- The [fntguide_] writes

  Note that ``\DeclareTextAccentDefault`` can be used on any
  one-argument encoding-specific command, not just those defined with
  ``\DeclareTextAccent``.

However, the simpler alternative
``\DeclareTextAccentDefault{\ensuregreek}{LGR}`` fails with the table of
Unicode characters in the test document `<textalpha-doc.tex>`__:

  ``! You can't use a prefix with `end-group character }'.`` -->
<p>Eventually, all font encodings supporting Greek script (e.g. LGI, PU, TU,
EU1, EU2) will declare <span class="docutils literal">\ensuregreek</span> as text command that passes the
argument unchanged. This way, kerning and selection of precomposed glyphs
would work also for cases like <span class="docutils literal"><span class="pre">\ensuregreek{\'A}U</span></span>.</p>
</div>
<div class="section" id="greek-alphabet">
<h3><a class="toc-backref" href="#id11">Greek Alphabet</a></h3>
<p>Define the <span class="docutils literal">text*</span> marcos as default for all font encodings:</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textAlpha}{LGR}
\DeclareTextSymbolDefault{\textBeta}{LGR}
\DeclareTextSymbolDefault{\textGamma}{LGR}
\DeclareTextSymbolDefault{\textDelta}{LGR}
\DeclareTextSymbolDefault{\textEpsilon}{LGR}
\DeclareTextSymbolDefault{\textZeta}{LGR}
\DeclareTextSymbolDefault{\textEta}{LGR}
\DeclareTextSymbolDefault{\textTheta}{LGR}
\DeclareTextSymbolDefault{\textIota}{LGR}
\DeclareTextSymbolDefault{\textKappa}{LGR}
\DeclareTextSymbolDefault{\textLambda}{LGR}
\DeclareTextSymbolDefault{\textMu}{LGR}
\DeclareTextSymbolDefault{\textNu}{LGR}
\DeclareTextSymbolDefault{\textXi}{LGR}
\DeclareTextSymbolDefault{\textOmicron}{LGR}
\DeclareTextSymbolDefault{\textPi}{LGR}
\DeclareTextSymbolDefault{\textRho}{LGR}
\DeclareTextSymbolDefault{\textSigma}{LGR}
\DeclareTextSymbolDefault{\textTau}{LGR}
\DeclareTextSymbolDefault{\textUpsilon}{LGR}
\DeclareTextSymbolDefault{\textPhi}{LGR}
\DeclareTextSymbolDefault{\textChi}{LGR}
\DeclareTextSymbolDefault{\textPsi}{LGR}
\DeclareTextSymbolDefault{\textOmega}{LGR}
%
\DeclareTextSymbolDefault{\textalpha}{LGR}
\DeclareTextSymbolDefault{\textbeta}{LGR}
\DeclareTextSymbolDefault{\textgamma}{LGR}
\DeclareTextSymbolDefault{\textdelta}{LGR}
\DeclareTextSymbolDefault{\textepsilon}{LGR}
\DeclareTextSymbolDefault{\textzeta}{LGR}
\DeclareTextSymbolDefault{\texteta}{LGR}
\DeclareTextSymbolDefault{\texttheta}{LGR}
\DeclareTextSymbolDefault{\textiota}{LGR}
\DeclareTextSymbolDefault{\textkappa}{LGR}
\DeclareTextSymbolDefault{\textlambda}{LGR}
\DeclareTextSymbolDefault{\textmu}{LGR}
\DeclareTextSymbolDefault{\textnu}{LGR}
\DeclareTextSymbolDefault{\textxi}{LGR}
\DeclareTextSymbolDefault{\textomicron}{LGR}
\DeclareTextSymbolDefault{\textpi}{LGR}
\DeclareTextSymbolDefault{\textrho}{LGR}
\DeclareTextSymbolDefault{\textsigma}{LGR}
\DeclareTextSymbolDefault{\textvarsigma}{LGR}
\DeclareTextSymbolDefault{\textfinalsigma}{LGR} % alias for \textvarsigma
\DeclareTextSymbolDefault{\textautosigma}{LGR}  % char 115 in LGR
\DeclareTextSymbolDefault{\texttau}{LGR}
\DeclareTextSymbolDefault{\textupsilon}{LGR}
\DeclareTextSymbolDefault{\textphi}{LGR}
\DeclareTextSymbolDefault{\textchi}{LGR}
\DeclareTextSymbolDefault{\textpsi}{LGR}
\DeclareTextSymbolDefault{\textomega}{LGR}</pre>
</div>
<div class="section" id="additional-greek-symbols">
<h3><a class="toc-backref" href="#id12">Additional Greek symbols</a></h3>
<p>Including alias names for compatibility with hyperref’s puenc.def.</p>
<p>Ancient Greek Numbers (Athenian Numerals):</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textpentedeka}{LGR}    % GREEK ACROPHONIC ATTIC FIFTY
\DeclareTextSymbolDefault{\textpentehekaton}{LGR} % GREEK ACROPHONIC ATTIC FIVE HUNDRED
\DeclareTextSymbolDefault{\textpenteqilioi}{LGR}  % GREEK ACROPHONIC ATTIC FIVE THOUSAND
\DeclareTextSymbolDefault{\textpentemurioi}{LGR}  % GREEK ACROPHONIC ATTIC FIFTY THOUSAND</pre>
<p>Archaic letters:</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textstigma}{LGR}      % ϛ
\DeclareTextSymbolDefault{\textstigmagreek}{LGR} % ϛ (puenc.def)
\DeclareTextSymbolDefault{\textvarstigma}{LGR}   % stigma variant
\DeclareTextSymbolDefault{\textkoppa}{LGR}       % ϟ (greek small letter koppa)
\DeclareTextSymbolDefault{\textkoppagreek}{LGR}  % ϟ (puenc.def)
\DeclareTextSymbolDefault{\textqoppa}{LGR}       % ϙ (archaic koppa)
\DeclareTextSymbolDefault{\textQoppa}{LGR}       % Ϙ (archaic Koppa)
\DeclareTextSymbolDefault{\textStigma}{LGR}      % Ϛ ϹΤ ligature in some fonts
\DeclareTextSymbolDefault{\textStigmagreek}{LGR} % Ϛ (puenc.def)
\DeclareTextSymbolDefault{\textSampi}{LGR}       % Ϡ
\DeclareTextSymbolDefault{\textSampigreek}{LGR}  % Ϡ (puenc.def)
\DeclareTextSymbolDefault{\textsampi}{LGR}       % ϡ
\DeclareTextSymbolDefault{\textsampigreek}{LGR}  % ϡ (puenc.def)
\DeclareTextSymbolDefault{\textanoteleia}{LGR}   % ·
\DeclareTextSymbolDefault{\texterotimatiko}{LGR} % ; (003B is the preferred character)
\DeclareTextSymbolDefault{\textdigamma}{LGR}     % ϝ
\DeclareTextSymbolDefault{\textDigamma}{LGR}     % Ϝ
\DeclareTextSymbolDefault{\textdigammagreek}{LGR} % ϝ (puenc.def)
\DeclareTextSymbolDefault{\textDigammagreek}{LGR} % Ϝ (puenc.def)</pre>
<p>numeral signs: <a class="reference external" href="http://en.wikipedia.org/wiki/Greek_numerals">http://en.wikipedia.org/wiki/Greek_numerals</a></p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textnumeralsigngreek}{LGR}      % (puenc.def)
\DeclareTextSymbolDefault{\textnumeralsignlowergreek}{LGR} % (puenc.def)</pre>
<div class="section" id="variant-shape-symbols">
<h4><a class="toc-backref" href="#id13">variant shape symbols</a></h4>
<p>Mathematical notation uses variant shapes of some Greek letters as
additional symbols.  There are separate code points for the symbol variants
in Unicode but not in the LGR font encoding used for Greek in 8-bit TeX.
The variations have no syntactic meaning in Greek text.</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\textbetasymbol}{LGR}    % ϐ GREEK BETA SYMBOL
\DeclareTextSymbolDefault{\textthetasymbol}{LGR}   % ϑ $\vartheta$ GREEK THETA SYMBOL
\DeclareTextSymbolDefault{\textphisymbol}{LGR}     % ϕ $\phi$ GREEK PHI SYMBOL
\DeclareTextSymbolDefault{\textpisymbol}{LGR}      % ϖ $\varpi$ GREEK PI SYMBOL
\DeclareTextSymbolDefault{\textkappasymbol}{LGR}   % ϰ GREEK KAPPA SYMBOL
\DeclareTextSymbolDefault{\textrhosymbol}{LGR}     % ϱ $\varrho$ GREEK RHO SYMBOL
\DeclareTextSymbolDefault{\textThetasymbol}{LGR}   % ϴ GREEK CAPITAL THETA SYMBOL
\DeclareTextSymbolDefault{\textepsilonsymbol}{LGR} % ϵ $\epsilon$ GREEK LUNATE EPSILON SYMBOL</pre>
<p>Define compatibility mappings if the <a class="reference internal" href="#normalize-symbols">normalize-symbols</a> option is set:</p>
<pre class="literal-block">\iftextalpha&#64;normalizeSymbols
  \DeclareTextCommand{\textbetasymbol}   {LGR}{\textbeta}
  \DeclareTextCommand{\textthetasymbol}  {LGR}{\texttheta}
  \DeclareTextCommand{\textphisymbol}    {LGR}{\textphi}
  \DeclareTextCommand{\textpisymbol}     {LGR}{\textpi}
  \DeclareTextCommand{\textkappasymbol}  {LGR}{\textkappa}
  \DeclareTextCommand{\textrhosymbol}    {LGR}{\textrho}
  \DeclareTextCommand{\textThetasymbol}  {LGR}{\textTheta}
  \DeclareTextCommand{\textepsilonsymbol}{LGR}{\textepsilon}
\fi</pre>
</div>
</div>
<div class="section" id="diacritics">
<h3><a class="toc-backref" href="#id14">Diacritics</a></h3>
<p>Greek diacritics via “named” macros:</p>
<pre class="literal-block">\DeclareTextAccentDefault{\accdasia}{LGR}
\DeclareTextAccentDefault{\accpsili}{LGR}
\DeclareTextAccentDefault{\acctonos}{LGR}
\DeclareTextAccentDefault{\accvaria}{LGR}
\DeclareTextAccentDefault{\accperispomeni}{LGR}
\DeclareTextAccentDefault{\accdialytika}{LGR}
%
\DeclareTextAccentDefault{\accdasiaoxia}{LGR}
\DeclareTextAccentDefault{\accdasiavaria}{LGR}
\DeclareTextAccentDefault{\accdasiaperispomeni}{LGR}
\DeclareTextAccentDefault{\accpsilioxia}{LGR}
\DeclareTextAccentDefault{\accpsilivaria}{LGR}
\DeclareTextAccentDefault{\accpsiliperispomeni}{LGR}
\DeclareTextAccentDefault{\accdialytikatonos}{LGR}
\DeclareTextAccentDefault{\accdialytikavaria}{LGR}
\DeclareTextAccentDefault{\accdialytikaperispomeni}{LGR}</pre>
<p>Symbol macros for the breathings:</p>
<pre class="literal-block">\DeclareTextAccentDefault{\&lt;}{LGR}
\DeclareTextAccentDefault{\&gt;}{LGR}</pre>
<p>Postfix accents:</p>
<pre class="literal-block">\DeclareTextSymbolDefault{\ypogegrammeni}{LGR} % &quot;small&quot; sub-iota
\DeclareTextSymbolDefault{\prosgegrammeni}{LGR}  % &quot;capital&quot; sub-iota</pre>
<p>Other accents in LGR:</p>
<pre class="literal-block">\DeclareTextAccentDefault{\accinvertedbrevebelow}{LGR} % INVERTED BREVE BELOW
\DeclareTextAccentDefault{\textsubarch}{LGR}           % tipa, Teubner name: ut
\DeclareTextAccentDefault{\accbrevebelow}{LGR}         % BREVE BELOW</pre>
</div>
<div class="section" id="auxiliary-macros">
<h3><a class="toc-backref" href="#id15">Auxiliary macros</a></h3>
<p><span class="docutils literal">\MakeUppercase</span> requires three internal commands:</p>
<pre class="literal-block">\DeclareTextAccentDefault{\LGR&#64;accdropped}{LGR}
\DeclareTextAccentDefault{\LGR&#64;accDialytika}{LGR}
\DeclareTextAccentDefault{\LGR&#64;hiatus}{LGR}</pre>
</div>
<div class="section" id="semicolon-as-erotimatiko">
<h3><a class="toc-backref" href="#id16">semicolon as erotimatiko</a></h3>
<p>The text command <span class="docutils literal">\textsemicolon</span> inserts <span class="docutils literal">\texterotimatiko</span>
in LGR font encoding and a “normal” semicolon else:</p>
<pre class="literal-block">\ProvideTextCommandDefault{\textsemicolon}{;}
\ProvideTextCommand{\textsemicolon}{LGR}{\texterotimatiko}</pre>
<p>The LGR font encoding maps “;” to a middle dot (ano teleia). With the
<a class="reference internal" href="#keep-semicolon">keep-semicolon</a> option, the semicolon is made an active character and calls
<span class="docutils literal">\textsemicolon</span>:</p>
<pre class="literal-block">\iftextalpha&#64;keepSemicolon
  \catcode`;=\active
  \newcommand{;}{\textsemicolon}
\fi</pre>
<!-- References
- - - - - - - - - - -->
</div>
</div>
</div>
</div>
</body>
</html>