| 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} |