<!--

Example of HTML code - from the Online ITRANS page at the ITRANS home
page:
    http://www.aczoom.com/itrans/

This snippet shows an example of how the FORM could be constructed -
this is just an example, there are many different ways this could be
done.

Note that the form should be edited in "form.tmpl" - this file is just an
example.

-->
<FORM METHOD="POST"
      ENCTYPE="multipart/form-data"
      ACTION="http:/cgi-bin/webitrans.pl"
      NAME="itxform">
  <TABLE CELLSPACING="0" CELLPADDING="10" BORDER="3" ALIGN="CENTER">
  <TR VALIGN="top">
    <TD WIDTH="40%">
      <b>1</b>: Select text format.
    </TD>
    <TD>
      <B>Text Format:</B> <select name="format">
	<option value="itrprose">Prose</option>
	<option value="itrverse">Verse (One column)</option>
	<option value="itrversetwocol">Verse (Two columns)</option>
	<option value="itrans-itx">ITRANS .itx input</option>
	<option value="isongs-s">ISONGS .s input</option>
      </select>
      [ <a href="#exformat">Examples</a> ]
      </select>
    </TD>
  </TR>
  <!--
  <TR>
    <TD COLSPAN="2">
    <b>2</b>: Select the Indian Language Script to use, and the
    size of the text.
    The "Enter {script-textsize}" button (shown below) copies
    selected script/text size commands to the text area.
    Each "{script-textsize}" directive
    applies to all the text that follows it, and is used for
      "Prose" and "Verse" text formats only.
    </TD>
  </TR>
    -->
  <TR>
    <TD>
      <b>2</b>: Select Script and Text Size.
    </TD>
    <TD>
      <B>Script:</B> <select name="language">
	<option value="sanskrit">sanskrit</option>
	<option value="hindi" selected>hindi</option>
	<option value="marathi">marathi</option>
	<option value="telugu">telugu</option>
	<option value="tamil">tamil</option>
	<option value="bengali">bengali</option>
	<option value="gujarati">gujarati</option>
	<option value="kannada">kannada</option>
	<option value="gurmukhi">gurmukhi</option>
	<option value="roman">roman</option>
      </select>
      &nbsp;&nbsp;
      <B>Text Size:</B> <select name="fontsize">
	<option value="small">small</option>
	<option value="normal">normal</option>
	<option value="large" selected>large</option>
	<option value="huge">huge</option>
      </select>
      <P>
      <CENTER>
      <input type="button" value="Enter {script-textsize} below" onClick="textcmd(this.form);">
      <BR>
      [ For "Prose" and "Verse" text formats only. ]
      </CENTER>
    </TD>
  </TR>
  <TR>
    <TD COLSPAN="2">
      <b>3a</b>: Enter text here:
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
      <input type="reset" value="[ Clear All ]">
      <P>
      <textarea  name="string" rows="20" cols="80" align="center"></textarea>
    </TD>
  </TR>
  <TR>
    <TD COLSPAN="2">
    <b>3b</b>: Use 3a to enter text, or select a file containing
    text (maximum of 500KB):
      <BR>
      Filename to upload:
	  <input type=file name="filename" size=35 maxlength="550000">
      <BR>
      HTTP URL to download:
	  <input type=text name="fileurl" size=35 maxlength="1024">
      <!-- above fileurl need not presented, if not needed, delete it
           or make it a hidden parameter as needed, example
	   input type=hidden name="fileurl" value="http://www.aczoom.com/isongs/hindi/a/15.s"
	-->
    </TD>
  </TR>
  <TR VALIGN="middle">
    <TD>
      <b>4a</b>: 
      Output File Format:
	<P>
	<input type="radio" name="output" value="itrtex" checked>GIF, PS, PDF, &amp; HTML
	<BR>
        &nbsp;&nbsp;&nbsp;&nbsp;
        [ takes 30-60 seconds ]
	<P>
	<input type="radio" name="output" value="itrhtmlonly"> HTML only
	<BR>
        &nbsp;&nbsp;&nbsp;&nbsp;
        [ takes 2-10 seconds ]
    </TD>
    <TD>
      <b>4b</b>: 
      &nbsp;&nbsp;&nbsp;&nbsp;
      <INPUT type="submit" value="Submit for processing ">
    </TD>
  </TR>
  </TABLE>

</FORM>

<CENTER>
<HR SIZE="2" WIDTH="100%">
</CENTER>

<B>Email any bug-reports or comments and suggestions to
<a href="mailto:avinash@aczoom.com">avinash@aczoom.com</a></B>
<BR>
Please note that no technical support is available for this web page
or for the tools on this web page.

<P>
If this site does not work for you, visit
<a href="http://sanskrit.gde.to/" target="_top">sanskrit.gde.to</a> which has
much more information as well as links to other such tools.

<CENTER>
<HR SIZE="2" WIDTH="100%">
</CENTER>

<A NAME="help"></A>
<H3>Tips, Examples, and Caveats</H3>

<UL>

<LI> To enter English text, surround it with ## ... ##
<BR>
[Both start and end should be enclosed with "##" - two hash-marks]
<BR>
Use same technique to enter any punctuation other text 
that should not be processed by ITRANS.
<BR>
The percent character % is a comment character in ITRANS - everything
from a % to the end of the line will be ignored.
<P>

<LI> To use multiple languages or multiple text sizes, 
specify
<FONT FACE="Courier New,Courier">{script-textsize}</FONT>
in the text itself.
You can use the buttons on
the form to enter that command automatically after selecting the appropriate
language script/text size value. Note that if all your text is to a single
size and a single script, there is no need to use the "Enter ..." buttons,
and that
these commands apply only to the "Verse" and "Prose" text formats;
they are not used for other text formats.
<P>

<LI> If the text format "ITRANS .itx input" is choosen, or
if a filename is uploaded and the name of the file ends in ".itx",
the input will be treated specially --- such text will be
directly processed by ITRANS (LaTeX mode), without any pre-processing
by this Online Interface to ITRANS (the {script-size} commands will
not be processed).
<P>

<LI> If the text format "ISONGS .s input" is choosen or 
if a filename is uploaded and the name of the file ends in ".s",
the input will be treated specially --- such text will be
processed as if the input were a ITRANS Song Book file, as shown
in this <a href="exisongs.html">ISONGS .s Example</a> (2000+ .s files
are available at the
<A HREF="http://www.aczoom.com/isongs/" TARGET="_top">ITRANS Song Book</A>
archive).
<P>

<LI>
<A NAME="exformat"></A>
Examples of the various options for the "Text Format":
<BR>
      <a href="prose.html">Prose</a>, &nbsp;
      <a href="verse.html">Verse</a>, &nbsp;
      <a href="exitrans.html">ITRANS .itx</a>, &nbsp;
      and &nbsp;
      <a href="exisongs.html">ISONGS .s</a> &nbsp;
<P>

<LI> For advanced users: list of <A HREF="commonWebInt.txt">common
mistakes and tips</A> on using this interface. [Not all tips
applicable to this interface.]
<P>

<LI> The button "Enter {script-textsize} below" 
will work only if JavaScript is enabled. All other features should
work on any browser that supports forms.
<P>

</UL>

<A NAME="htmlissues"></A>
<H3>HTML Output Issues</H3>
HTML Output for direct display on Web Pages has many limitations:
    <UL>

    <P>
    <LI> HTML output is created in two formats: ISO-Latin1 (user-defined) 
    encoding and Unicode UTF-8 encoding. Best to ignore old Latin1 output,
    and use UTF-8 HTML files only.

    <P>
    <LI>Consider the HTML Latin1 output to be a quick but
    approximate way
    to test your input, the best formatted output is only available
    in GIF, PS, UTF-8, or PDF formats.
    The HTML Unicode UTF-8 output is of use if you
    have a platform that supports Indian Languages using Unicode, you can
    then cut and paste or load the HTML Unicode output to your word-processor,
    and use that to edit and format your text as required.
    </UL>

<H4>HTML Unicode (UTF-8) Encoding</H4>

    <UL>
    <P>
    <LI> For the Unicode UTF-8 format: there must be compatible
    Unicode fonts installed on your system for viewing.
    <BR>
    For Windows, there are a few Unicode fonts available, you can
    search for them on the web.
    One such font:
    <A HREF="http://office.microsoft.com/downloads/2000/aruniupd.aspx">Office
    2000 - Arial Unicode MS Download</A> [ 15 MBytes ].
    Note that this font does not have conjunct consonants - it uses
    viraam to denote a half-consonant.

    <P>
    <LI>
    The  Unicode output can be viewed  
    correctly on your computer if there is 
    a Unicode font with support for Indian Language Scripts installed,
    and the web browser is configured to use that font for
    Unicode UTF-8 documents.

    <P>
    <LI>
    If the browser is unable to display text in Indian Languages, but
    you know your platform has a Unicode font and Unicode text editor,
    another option is to save the output file to local disk, and open it
    using your text editor (like Word 2000 or Office XP), and changing the
    text to a Unicode font that has Indian Language characters.

    <P>
    <LI>
    Browser settings: Netscape 4.77: Click on Edit -> Preferences ->
    Appearance -> Fonts. For the encoding "Unicode", select a Indian Language
    Unicode font for both the "Variable Width Font" and "Fixed Width Font".
    For IE 5.x: It is unclear how IE selects fonts - it does not show
    Unicode as a text encoding
    (Tools -> Internet Options -> General -> Fonts). There is a "Devanagari"
    choice available here, but there seems to
    be no way to assign currently available fonts to both
    "Web Page Font" and "Plain Text Font" for Devanagari. 
    So, this may not work with IE at all, Microsoft is messy as usual. The
    only available option in that case is to save the output file to disk,
    as mentioned in a previous paragraph.

    </UL>

<H4>HTML ISO-Latin1 (User-Defined) Encoding</H4>

    <UL>
    <P>
    <LI>
    The ISO Latin1 encoding is actually a "User Defined" encoding, and
    it can be viewed correctly only if the browser allows "fake" ISO Latin1
    fonts (i.e., they have 256 glyphs, but actually contain Indic Script
    characters) to be used in a document.

    <P>
    <LI> Only a few language scripts
    supported: Hindi/Marathi/Sanskrit,
    Gujarati, Bengali, Romanized Sanskrit. Even for these scripts,
    the output is approximate and punctuation is not handled very well.

    <P>
    <LI> Only Microsoft Windows platforms will likely be able
    to display the HTML output. Internet Explorer 4.0
    (or newer), on any platform,
    may be able to display the pages without requiring any font
    installation (<A HREF="http://www.microsoft.com/typography/web/embedding/weft3/weft00.htm" target="_top">embedded font objects</A> used),
    but Netscape or any other browser will require installation of
    the TrueType fonts used in the output.
    <P>
    [May 2001: Only Xdvng and NCS_CSX+ fonts are currently embedded,
    so as to keep the page loading times as low as possible.
    Bengali and Gujarati fonts need to be manually installed on all systems.]
    <P>
    Here are the fonts for each supported script:
    <P>
    &nbsp;
    Xdvng for Hindi, Marathi, Sanskrit:
    <A HREF="fonts/xdvng.ttf">xdvng.ttf</A>
    <BR>
    &nbsp;
    ItxGuj for Gujarati:
    <A HREF="fonts/itxguj.ttf">itxguj.ttf</A>
    <BR>
    &nbsp;
    ItxBeng for Bengali:
    <A HREF="fonts/itxbeng.ttf">itxbeng.ttf</A>
    <BR>
    &nbsp;
    NCS_CSX+ for Romanized Sanskrit:
    <A HREF="fonts/ncpr____.ttf">ncpr____.ttf</A>
    &nbsp;&nbsp;&nbsp;&nbsp;
    [ from
    <A HREF="ftp://bombay.oriental.cam.ac.uk/pub/john/software/fonts/csx+/"
       TARGET="_top">Dr. John Smith's FTP Site - Fonts</A> ]
    <P>
    All the fonts above are freeware, and copyrights are held by their
    authors. Visit the 
    <A HREF="http://www.aczoom.com/itrans/" TARGET="_top">ITRANS</A>
    section for complete documentation.

    <P>
    <LI>
    Browser settings: Netscape 4.7: This should work without any settings.
    If not, use the View -> Character Set to select "User-Defined", hopefully
    that will fix the display.
    For IE 5.x: Click View -> Encoding, and select Auto-Select. Or, force
    select "User Defined".
    Even after installing the fonts and tweaking the browser settings,
    the Indic Script display may be inaccurate.
    </UL>

<P>

<P>
<CENTER>
  <IMG SRC="/images/blueline2.gif" ALT="[[----blueline2.gif----]]"
    WIDTH="560" HEIGHT="11">
</CENTER>
<!-- =============================== ========================= -->
<P>
<CENTER>
  <TABLE BORDER="1" CELLPADDING="7">
    <TR ALIGN="center">
      <TD>
	<FONT SIZE="+0"> <A HREF="http://www.aczoom.com/tools/" TARGET="_top">Software Tools</A> </FONT>
      </TD>
    </TR>
  </TABLE>
</CENTER>
<P>
<CENTER>
  <TABLE BORDER="1" CELLPADDING="7">
    <TR ALIGN="center">
      <TD>
	<FONT SIZE="+0"> <A HREF="http://www.aczoom.com/" TARGET="_top">ACZoom Home</A> </FONT>
      </TD>
      <TD>
	<FONT SIZE="+0"> <A HREF="http://www.aczoom.com/itrans/" TARGET="_top">ITRANS</A> </FONT>
      </TD>
      <TD>
	<FONT SIZE="+0"><A HREF="http://www.aczoom.com/isongs/" TARGET="_top">ITRANS Song Book</A></FONT>
      </TD>
      <TD>
	<FONT SIZE="+0"> <A HREF="http://www.aczoom.com/avigb.html" TARGET="_top">Guestbook</A> </FONT>
      </TD>
      <TD>
	<FONT SIZE="+0"> <A HREF="http://www.aczoom.com/email.html" TARGET="_top">E-mail</A> </FONT>
      </TD>
    </TR>
  </TABLE>
</CENTER>
<P>

<CENTER>
<HR SIZE="2" WIDTH="100%">
</CENTER>
<!-- =============================== end trailer ========================= -->

<IMG SRC="/images/linux.logosml.32.gif" ALT="--Linux Rules!--"
  WIDTH=92 HEIGHT=39 ALIGN="right">

<FONT SIZE="-1"> Page produced and maintained by: Avinash Chopde
&lt;<a href="mailto:avinash@aczoom.com">avinash@aczoom.com</a>&gt;, &nbsp;
<A href="http://www.aczoom.com/" TARGET="_top">
http://www.aczoom.com/</A>.
</FONT>
<BR>
Last modified: 30 May, 2001.
</BODY></HTML>
