summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/greek-inputenc/README
blob: ed76ddd9e366c896007482bf7fb3bc9d9d114bb1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
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/macros/latex/contrib/lgrx/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_.  For example ::

  \usepackage[iso-8859-7]{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" or
"polutonikogreek" options 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