greek-inputenc
##############
Greek input encoding definition files
*************************************

:Author:    Apostolos Syropoulos, Dimitrios Filippou, Günter Milde
:Date:      2013-05-16
:Copyright: © 1999 Dimitrios Filippou
            © 2000 Apostolos Syropoulos
            © 2013 Günter Milde <milde@users.sf.net>
:Licence:   This work may be distributed and/or modified under the
            conditions of the `LaTeX Project Public License`_, either
            version 1.3 of this license or any later version.
:Abstract:  This package provides input encoding definition
            files for Greek for use with inputenc_.
            

News            
====

:May 2013: * new maintainer.
           * Unicode support with the standard "utf8" option.

Files
=====

`<lgrenc.dfu>`_
  Greek input encoding file for UTF-8 comprising Greek letters and other
  symbols present in the LGR encoding.

  This file requires ``lgrenc.def`` version 0.8.2 or newer from the
  greek-fontenc_ package.

  The literate source was converted with PyLit_ to reStructuredText_ and
  with Docutils_ to `<lgrenc.dfu.html>`_.

`<iso-8859-7.def>`_
  Greek input encoding file for `ISO 8859-7`_ by Apostolos Syropoulos.
  [#transliteration]_

`<macgreek.def>`_
  Greek input encoding file for Macintosh (ELOT 823) by Dimitrios Filippou.
  [#transliteration]_

Test examples and output:
  :utf-8:      `<test-utf8.tex>`_, `<test-utf8.pdf>`_ (comprehensive example)
  :iso 8859-7: `<test-iso-8859-7.tex>`_, `<test-iso-8859-7.pdf>`_ (basic test)


.. [#transliteration] Currently, these files translate to a Latin
   transcription particular to the LGR font encoding. Drawbacks include:
   Latin characters in PDF strings (hyperref_ bookmarks and TOC sidebar, cf.
   greekhyperref.pdf__), no kerning between accented characters.

__ http://mirrors.ctan.org/language/greek/greek-fontenc/greekhyperref.pdf


Installation
============

If possible, get this package from your distribution using its installation
manager.

Otherwise, make sure LaTeX can find the files ending in ``.def``:

* Download and unpack `greek-inputenc.zip` or just download the required
  file(s).

* Copy, move, or link the files to a suitable place in the `TeX Directory
  Structure` (TDS_) and run ``texhash``, or place them in the current working
  directory (e.g. for testing).

Usage
=====

Pass the encoding name as option to inputenc_.

The "utf8" option only defines characters that are accessible in declared
font encodings. In order to load the Greek definitions in ``lgrenc.dfu``,
specify the LGR font encoding with fontenc_ or the "greek" option for
babel_, e.g. ::

     \usepackage[LGR,T1]{fontenc}
     \usepackage[utf8]{inputenc}

or ::

     \usepackage[greek,english]{babel}
     \usepackage[utf8]{inputenc}

See `test-utf8.tex`_ for an example.



.. References
   ==========

.. _ISO 8859-7: http://en.wikipedia.org/wiki/ISO/IEC_8859-7

.. _LaTeX Project Public License: http://www.latex-project.org/lppl.txt
.. _PyLit: http://pylit.berlios.de
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _Docutils: http://docutils.sourceforge.net/rst.html
.. _TDS: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds

.. _babel: http://www.ctan.org/pkg/babel
.. _fontenc:  http://www.ctan.org/pkg/fontenc
.. _greek-fontenc:  http://www.ctan.org/pkg/greek-fontenc
.. _hyperref: http://www.ctan.org/pkg/hyperref
.. _ibycus-babel: http://www.ctan.org/pkg/ibycus-babel
.. _inputenc:  http://www.ctan.org/pkg/inputenc
.. _lgrx: http://www.ctan.org/pkg/lgrx