Subsections

• TEX Requirements
• L^ATEX Style Files

TEX Interface

itrans can accept TEX input and generate TEX output for all languages for which either a PostScript font description or a Metafont description is available.

For example, the character in the table in the document dvnc.itx was produced by this input text:

{#marathi aa #endmarathi }

Thus, the character aa, when bracketed between #marathi and #endmarathi produces , when the appropriate IFM file name and font command name have been set correctly (as mentioned in the previous section).

For further examples, see the sample documents provided. All TEX transliterated files have been given the file extension .itx.

Normally, all english text between the words #marathi and #endmarathi is mapped into marathi characters, except for any word following a backslash character. Thus, you can include TEX commands in the transliterated text portion, the only restriction is that the command should be made up of letters and numerals only.

Examples: \indent or \hskip1in or \kern0.4em, etc. Note that in the sample documents shown, TEX commands are usually surrounded by curly braces--they used as scope delimiters only, are not absolutely necessary, but are recommended.

TEX Requirements

To use this pre-processor, you must have the following tools:

1. TEX tools, including the capability to output dvi files using PostScript fonts (if you need to use the devnac devanagari font). This implies having dvips, release 5.41 or newer, a program written by Tomas Rokicki. If you don't have it, see the Frequently-Asked-Questions in the newsgroup comp.text.tex for details on how to get hold of dvips. Actually, if you only need to use tamil or Frans Velthuis's Devnag font, or telugu, you don't need a dvi-to-ps converter. Those fonts are described in Metafont, thus any dvi-to-your-printer converter will be able to handle it (once you run Metafont and generate the printer specific files).

   For the IBM PC, the emTeX package includes the dvips executable. dvips for the PC also resides in the SIMTEL archives.

2. ANSI C compatible compiler, and optionally, the flex and yacc tools. This program is provided with the source code, and a makefile. The makefile is specific to my machine, you may have to edit it to get it working correctly on your machine. If you do not have an ANSI C compatible compiler, you will have to make the ``noansi'' object, see the makefile for details; it automatically de-ansifies all the C sources. Also, if you need to modify the ilex.l or iyacc.y source files for your specific needs, you'll need the flex and yacc tools on your system.

   The ITRANS package also contains an executable for MS-DOS machines, thus for MS-DOS machines, you need not go through the compilation step.

L^ATEX Style Files

In ITRANS release 5.2, a new style file was added itrans.sty. This is the file created by Ross Moore to allow ITRANS documents to be processed through latex2html, but this style file is useable for normal L^ATEXdocuments also.

This style file should be loaded with the \usepackage command, and there are many options available with this package.

preprocess

This is applicable only when using latex2html, and it has no effect when running normal L^ATEX. So, it is probably ok to always use this option even if you never plan on running latex2html.

devanagari

This will load the idevn.tex file, which has some macros that are useful for using Devanagari with TEX. idevn.tex will actually be loaded even if no option is provided, so the devanagari option is not really necessary at this time (ITRANS release 5.2).

telugu

This will load the itrnstlg.tex file, which has some macros that are useful for generating some special Telugu characters.

other options

itrans.sty has many other options, take at look at that file to view all of them, but in practice, you may not need to use any of those options yet.

Example lines to load itrans.sty:

\usepackage[preprocess]{itrans}} or

\usepackage[preprocess,telugu]{itrans}}