Debian Codegraph @

texmf-dist/doc/xelatex/xetex-itrans/README

raw
1 % README for ITRANS and Baraha mapping files to be used with XeLaTeX.
2 % Copyright (C) 2010-2014, Abhinandan S. Prasad and Shrisha Rao.
3 %
4 % Version 4.2, Time-stamp: <2014-09-01 11:47:23 shrao>
5 %
6 % This work may be distributed and/or modified under the
7 % conditions of the LaTeX Project Public License, either version 1.3
8 % of this license or (at your option) any later version.
9 % The latest version of this license is in
10 % http://www.latex-project.org/lppl.txt
11 % and version 1.3 or later is part of all distributions of LaTeX
12 % version 2005/12/01 or later.
13 %
14 % This work has the LPPL maintenance status `maintained'.
15 %
16 % The Current Maintainer of this work is Shrisha Rao.
17 %
18 % This work consists of the files brh-kan.map, brh-kan.tec,
19 % itrans-dvn.map, itrans-dvn.tec, itrans-sdvn.map, itrans-sdvn.tec,
20 % itrans-iast.map, itrans-iast.tec, itrans-kan.map, itrans-kan.tec,
21 % itrans-sankan.map, itrans-sankan.tec, itrans-santel.map,
22 % itrans-santel.tec, itrans-tamil.map, itrans-tamil.tec,
23 % itrans-tamil-sample.pdf, itrans-tamil-sample.tex, itrans-tel.map,
24 % itrans-tel.tec, and README.
25
26 The following files are mappings that can be used with XeLaTeX for
27 codings done in the ITRANS and Baraha formats. In each instance, the
28 *.map file is the actual (ASCII) mapping, while the *.tec file is the
29 compiled version used by the software.
30
31 The itrans-tel mapping is by Kattamuri Ekanadham.
32
33 brh-kan: This mapping should be used with codings done in Baraha,
34 where the output is desired in Kannada script.
35
36 itrans-dvn: This mapping should be used with codings done in ITRANS,
37 where the output is desired in Devanagari script. The
38 codings are typically, but not necessarily, of Sanskrit
39 texts (they could also be, e.g., Hindi or Marathi).
40
41 itrans-sdvn: This mapping is very similar to the above, but does not
42 need the use of a vowel `a' at the ends of words; thus,
43 `rAm' can be used rather than `rAma'.
44
45 itrans-iast: This mapping should be used with codings done in ITRANS,
46 where the output is desired in accented Roman (IAST)
47 script.
48
49 itrans-kan: This mapping should be used with codings done in ITRANS
50 of Kannada texts, where the output is desired in Kannada
51 script.
52
53 itrans-sankan: This mapping should be used with codings done in ITRANS
54 of Sanskrit texts, where the output is desired in Kannada
55 script.
56
57 itrans-santel: This mapping should be used with codings done in ITRANS
58 of Sanskrit texts, where the output is desired in Telugu
59 script.
60
61 itrans-tamil: This mapping should be used with codings done in ITRANS
62 of Tamil texts, where the output is desired in Tamil
63 script.
64
65 itrans-tel: This mapping should be used with codings done in ITRANS
66 of Telugu texts, where the output is desired in Telugu
67 script.
68
69 Note that `e' and `o' get mapped to the long-vowels with itrans-sankan
70 and in itrans-santel, but to the short vowels in itrans-kan and
71 itrans-tel (where `E' and `O' are needed for the long vowels).
72
73 To use these mappings, insert one or more of the following sets of
74 lines in your *.tex files after the \documentclass command and
75 appropriate other includes and settings.
76
77 \newcommand\abc{\catcode`\^=11
78 \catcode`\~=11
79 \fontspec[Script=Kannada,Mapping=brh-kan]{<fontname>}}
80
81 \newcommand\abc{\catcode`\^=11
82 \catcode`\~=11
83 \fontspec[Script=Devanagari,Mapping=itrans-dvn]{<fontname>}}
84
85 \newcommand\abc{\catcode`\^=11
86 \catcode`\~=11
87 \fontspec[Script=Devanagari,Mapping=itrans-sdvn]{<fontname>}}
88
89 \newcommand\abc{\catcode`\^=11
90 \catcode`\~=11
91 \fontspec[Script=Roman,Mapping=itrans-iast]{<fontname>}}
92
93 \newcommand\abc{\catcode`\^=11
94 \catcode`\~=11
95 \fontspec[Script=Kannada,Mapping=itrans-kan]{<fontname>}}
96
97 \newcommand\abc{\catcode`\^=11
98 \catcode`\~=11
99 \fontspec[Script=Kannada,Mapping=itrans-sankan]{<fontname>}}
100
101 \newcommand\abc{\catcode`\^=11
102 \catcode`\~=11
103 \fontspec[Mapping=itrans-santel]{<fontname>}}
104
105 \newcommand\abc{\catcode`\^=11
106 \catcode`\~=11
107 \fontspec[Script=Tamil,Mapping=itrans-tamil]{<fontname>}}
108
109 \newcommand\abc{\catcode`\^=11
110 \catcode`\~=11
111 \fontspec[Mapping=itrans-tel]{<fontname>}}
112
113 Replace `abc' by the desired macro name, and <fontname> by the name of
114 an appropriate Unicode font in that script (e.g., Sanskrit 2003 for
115 Devanagari, Kedage for Kannada, Pothana for Telugu).
116
117 The following is a small example using the Kannada `Kedage' font.
118 Save the following as a *.tex file; if your installation and settings
119 (including fonts) are correct, it will compile and produce a proper
120 PDF output. (See itrans-tamil-sample.tex and itrans-tamil-sample.pdf
121 for a Tamil usage example.)
122
123 \documentclass[a4paper,11pt]{article}
124
125 \usepackage{ifxetex}
126 \RequireXeTeX
127 \usepackage{xltxtra}
128
129 \setlength{\parindent}{0mm}
130
131 \newcommand\ked{\catcode`\^=11
132 \catcode`\~=11
133 \fontspec[Script=Kannada,Mapping=itrans-sankan]{Kedage}}
134
135 \begin{document}
136
137 {\ked
138 OM || nArAyaNaM suraguruM jagadekanAthaM \\
139 bhaktapriyaM sakalalokanamaskR^itaM cha | \\
140 traiguNyavarjitamajaM vibhumAdyamIshaM \\
141 vande bhavaghnamamarAsurasiddhavandyam.h ||
142 }
143
144 \end{document}