summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/xetex-itrans/README
blob: a86cbe457aeae5f635f12832107a582d2cfbf1c8 (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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
% README for ITRANS and Baraha mapping files to be used with XeLaTeX.
% Copyright (C) 2010-2014, Abhinandan S. Prasad and Shrisha Rao.
% 
% Version 4.2, Time-stamp: <2014-09-01 11:47:23 shrao>
%
%   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 (at your option) any later version.
%   The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
%   and version 1.3 or later is part of all distributions of LaTeX
%   version 2005/12/01 or later.
%
%   This work has the LPPL maintenance status `maintained'.
% 
%   The Current Maintainer of this work is Shrisha Rao.
%
%   This work consists of the files brh-kan.map, brh-kan.tec,
%   itrans-dvn.map, itrans-dvn.tec, itrans-sdvn.map, itrans-sdvn.tec,
%   itrans-iast.map, itrans-iast.tec, itrans-kan.map, itrans-kan.tec,
%   itrans-sankan.map, itrans-sankan.tec, itrans-santel.map,
%   itrans-santel.tec, itrans-tamil.map, itrans-tamil.tec,
%   itrans-tamil-sample.pdf, itrans-tamil-sample.tex, itrans-tel.map,
%   itrans-tel.tec, and README.

The following files are mappings that can be used with XeLaTeX for
codings done in the ITRANS and Baraha formats.  In each instance, the
*.map file is the actual (ASCII) mapping, while the *.tec file is the
compiled version used by the software.

The itrans-tel mapping is by Kattamuri Ekanadham.

brh-kan:       This mapping should be used with codings done in Baraha,
               where the output is desired in Kannada script.

itrans-dvn:    This mapping should be used with codings done in ITRANS, 
               where the output is desired in Devanagari script.  The
               codings are typically, but not necessarily, of Sanskrit
               texts (they could also be, e.g., Hindi or Marathi).

itrans-sdvn:   This mapping is very similar to the above, but does not
               need the use of a vowel `a' at the ends of words; thus,
               `rAm' can be used rather than `rAma'.

itrans-iast:   This mapping should be used with codings done in ITRANS,
	       where the output is desired in accented Roman (IAST)
	       script.

itrans-kan:    This mapping should be used with codings done in ITRANS
               of Kannada texts, where the output is desired in Kannada
               script.

itrans-sankan: This mapping should be used with codings done in ITRANS
               of Sanskrit texts, where the output is desired in Kannada
               script.

itrans-santel: This mapping should be used with codings done in ITRANS
	       of Sanskrit texts, where the output is desired in Telugu
	       script.

itrans-tamil:  This mapping should be used with codings done in ITRANS
               of Tamil texts, where the output is desired in Tamil
               script.

itrans-tel:    This mapping should be used with codings done in ITRANS 
               of Telugu texts, where the output is desired in Telugu
               script.

Note that `e' and `o' get mapped to the long-vowels with itrans-sankan
and in itrans-santel, but to the short vowels in itrans-kan and
itrans-tel (where `E' and `O' are needed for the long vowels).

To use these mappings, insert one or more of the following sets of
lines in your *.tex files after the \documentclass command and
appropriate other includes and settings.

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Script=Kannada,Mapping=brh-kan]{<fontname>}}   

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Script=Devanagari,Mapping=itrans-dvn]{<fontname>}}   

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Script=Devanagari,Mapping=itrans-sdvn]{<fontname>}} 

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Script=Roman,Mapping=itrans-iast]{<fontname>}}

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Script=Kannada,Mapping=itrans-kan]{<fontname>}}

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Script=Kannada,Mapping=itrans-sankan]{<fontname>}}

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Mapping=itrans-santel]{<fontname>}}

\newcommand\abc{\catcode`\^=11
            \catcode`\~=11
           \fontspec[Script=Tamil,Mapping=itrans-tamil]{<fontname>}}

\newcommand\abc{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Mapping=itrans-tel]{<fontname>}}

Replace `abc' by the desired macro name, and <fontname> by the name of
an appropriate Unicode font in that script (e.g., Sanskrit 2003 for
Devanagari, Kedage for Kannada, Pothana for Telugu).

The following is a small example using the Kannada `Kedage' font.
Save the following as a *.tex file; if your installation and settings
(including fonts) are correct, it will compile and produce a proper
PDF output.  (See itrans-tamil-sample.tex and itrans-tamil-sample.pdf
for a Tamil usage example.)

\documentclass[a4paper,11pt]{article}

\usepackage{ifxetex}
\RequireXeTeX
\usepackage{xltxtra}

\setlength{\parindent}{0mm}

\newcommand\ked{\catcode`\^=11
           \catcode`\~=11
           \fontspec[Script=Kannada,Mapping=itrans-sankan]{Kedage}}

\begin{document}

{\ked
OM ||  nArAyaNaM suraguruM jagadekanAthaM \\
bhaktapriyaM sakalalokanamaskR^itaM cha | \\
traiguNyavarjitamajaM vibhumAdyamIshaM \\
vande bhavaghnamamarAsurasiddhavandyam.h  ||
}

\end{document}