thdltools/www
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
www/htdocs/tibwn_ini_file_format.html

462 lines
15 KiB
HTML
Raw Normal View History

An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
<!-- @author David Chandler -->
<!-- @date-created October 20, 2002 -->
<!-- @editor Emacs, baby! -->
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<head>
<title>tibwn.ini File Format</title>
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
Using absolute links to iris, not relative.
2003-11-01 04:50:02 +00:00
<script type="text/javascript" src="http://iris.lib.virginia.edu/tibet/scripts/thdl_scripts.js"></script>
<link rel="stylesheet" type="text/css" href="http://iris.lib.virginia.edu/tibet/style/thdl-styles.css"/>
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
</head>
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<body>
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<div id="banner">
Using absolute links to iris, not relative.
2003-11-01 04:50:02 +00:00
<a id="logo" href="http://iris.lib.virginia.edu/tibet/index.html"><img id="test" alt="THDL Logo" src="http://iris.lib.virginia.edu/tibet/images/logo.png"/></a>
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<h1>The Tibetan &amp; Himalayan Digital Library</h1>
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<div id="menubar">
<script type='text/javascript'>function Go(){return}</script>
Using absolute links to iris, not relative.
2003-11-01 04:50:02 +00:00
<script type='text/javascript' src='http://iris.lib.virginia.edu/tibet/scripts/new/thdl_menu_config.js'></script>
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
Using absolute links to iris, not relative.
2003-11-01 04:50:02 +00:00
<script type='text/javascript' src='http://iris.lib.virginia.edu/tibet/scripts/new/menu_new.js'></script>
<script type='text/javascript' src='http://iris.lib.virginia.edu/tibet/scripts/new/menu9_com.js'></script>
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<noscript><p>Your browser does not support javascript.</p></noscript>
<div id='MenuPos' >Menu Loading... </div>
</div><!--END menubar-->
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
</div><!--END banner-->
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<div id="sub_banner">
<div id="search">
<form method="get" action="http://www.google.com/u/thdl">
<p>
<input type="text" name="q" id="q" size="15" maxlength="255" value="" />
<input type="submit" name="sa" id="sa" value="Search"/>
<input type="hidden" name="hq" id="hq" value="inurl:iris.lib.virginia.edu"/>
</p>
</form>
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
</div>
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<div id="breadcrumbs">
Using absolute links to iris, not relative.
2003-11-01 04:50:02 +00:00
<a href="http://iris.lib.virginia.edu/tibet/index.html">Home</a> &gt; <a href="index.html">Tools</a> &gt; <a href="http://iris.lib.virginia.edu/tibet/tools/software.html">Software</a> &gt; Nightly Builds
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
</div>
</div><!--END banner-->
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<div id="main">
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
<h2>tibwn.ini File Format</h2>
<p>
<a
href="http://iris.lib.virginia.edu/tibet/tools/jskad.html">Jskad</a>
and <a
href="http://iris.lib.virginia.edu/tibet/tools/wyword.html">WylieWord</a>
Elaborated for developers. The code in question (TMW->ACIP for the TMW for U+0FAD) is not yet committed, but will be soon.
2004-04-11 14:14:49 +00:00
both make use of a data file named <a
href="http://cvs.sourceforge.net/viewcvs.py/thdltools/Jskad/source/org/thdl/tib/text/tibwn.ini?view=markup"><code>tibwn.ini</code></a>.&nbsp;
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
This document concerns the structure and content of that data file.
</p>
<p>
The purpose of the file is to encode all knowledge of the <a
href="http://iris.lib.virginia.edu/tibet/tools/tm.html">Tibetan
Machine</a> (TM) and <a
href="http://iris.lib.virginia.edu/tibet/tools/tmw.html">Tibetan
Machine Web</a> (TMW) fonts.&nbsp; Specifically, the following
knowledge is found:
</p>
<ul>
<li>
which TM glyphs corresponds to which TMW glyphs (a two-way
mapping, which is one-to-one except for TMW7.90 and TMW7.91, which
both map to the same TM glyph for our purposes)
</li>
<li>
which TM glyphs corresponds to which TMW glyphs (a two-way
mapping, which is one-to-one except for TMW7.90 and TMW7.91, which
both map to the same TM glyph for our purposes)
</li>
<li>
which Unicode codepoints are suitable for a TM or TMW to Unicode
conversion
</li>
<li>
which THDL Extended Wylie is suitable for a TM or TMW to Wylie
conversion
</li>
<li>
which vowel/bindu/vowel+bindu/achung-as-vowel glyphs correspond to
which consonant/consonant stack glyphs (needed for composing
beautiful stacks; needed for Wylie->TMW conversions and input
methods).
</li>
</ul>
<p>
Much of this knowledge is found in the <a
href="http://iris.lib.virginia.edu/tibet/tools/tib5doc.pdf">documentation</a>
for the TM and TMW fonts.&nbsp; Note the <a
href="Tibetan51Errata.html">errata</a> for this document, as it
especially concerns the data in <code>tibwn.ini</code>.
</p>
<h3>File Format -- Overview</h3>
<p>
The <code>tibwn.ini</code> file format allows for comments, blank
lines (entirely blank, containing not even whitespace), Section
headers, comma-delimited lists, and newline-delimited rows of
tilde-delimited data.&nbsp; A comment line is any line that begins
with two slashes ('//'); the entire line is ignored.&nbsp; A blank
line is ignored, too.&nbsp; A section header is a line
'&lt;?<i>section-name</i>?&gt;'.&nbsp; A comma-delimited list must
fit entirely on one line.
</p>
<h3>File Format -- Sections</h3>
<p>
The <code>tibwn.ini</code> file is broken up into sections.&nbsp;
Currently, these are as follows:
</p>
<ul>
<li>
Consonants - set of Tibetan/Tibetanized Sanskrit consonants that
the application reading tibwn.ini supports; does not include
stacks
</li>
<li>
Numbers - set of Tibetan numbers that the application reading
tibwn.ini supports
</li>
<li>
Vowels - set of Tibetan vowels that the application reading
tibwn.ini supports
</li>
<li>
Other - set of Tibetan punctuation and other characters that the
application reading tibwn.ini supports
</li>
<li>
Input:Punctuation - application-independent data for all Tibetan
punctuation and other miscellaneous characters that can be listed
in the Other section
</li>
<li>
Input:Vowels - application-independent data for all Tibetan vowels
that can be listed in the Vowels section
</li>
<li>
Input:Tibetan - application-independent data for all Tibetan
consonants and Tibetan (but not Tibetanized Sanskrit) consonant
stacks that can be listed in the Consonants section
</li>
<li>
Input:Numbers - application-independent data for all Tibetan
numbers that can be listed in the Numbers section
</li>
<li>
Input:Sanskrit - application-independent data for all Tibetanized
Sanskrit stacks
</li>
<li>
ToWylie - data needed merely for Tibetan-to-THDL Extended Wylie
and Tibetan-to-Unicode conversions
</li>
<li>
Ignore - a section containing data to be ignored for all purposes
other than Tibetan-to-Unicode conversions (should probably be
called ToUnicode at this point <!-- FIXME -->, but is called
Ignore because it was once entirely ignored)
</li>
</ul>
<p>
The Consonants, Numbers, Vowels, and Other sections contain
comma-delimited lists of the THDL Extended Wylie representations of
each consonant, number, etc. that the application reading
<code>tibwn.ini</code> wishes to support.&nbsp; Note that it is not
possible to represent a comma (though extending the file format to
do so would likely work along the same lines as the support for '~'
characters via __TILDE__).&nbsp; These sections should probably be
discarded entirely so that applications and users can choose which
characters to support themselves.&nbsp; The rest of the file is
application-independent.<!-- FIXME -->
</p>
<p>
The remaining sections are the meat of the file.&nbsp; Each one
contains zero or more rows of data, one row per line.&nbsp; Each
line looks like this:
</p>
<pre>
h~61,1~1,100~1,62~1,109~1,112~1,123~1,125~10,115~10,122~0F67~1,102~
</pre>
<p>
Each line describes one glyph in the Tibetan Machine Web font.&nbsp;
There are thirteen tilde-delimited columns per line, though the last
two columns are optional.&nbsp; An empty column takes no space; for
example,
</p>
<pre>
_~32,1~~2,32~~~~~~~0020
</pre>
<p>
has non-empty data for only columns 1 (the first column, i.e. the one
containing an underscore), 2, 4, and 11.&nbsp; When it is desirable to
represent a tilde ('~') character, __TILDE__ is used.&nbsp; For
example, in the THDL Extended Wylie for nyi zla, a tilde is used, so
this line occurs:
</p>
<pre>
__TILDE__^~91,5~~9,89~~~~~~~0F82
</pre>
<p>
The columns themselves each have a meaning.&nbsp; They are as
follows:
</p>
<ul>
<li>
Column 1 - the THDL Extended Wylie corresponding to this glyph
</li>
<li>
Column 2 - '<i>ord</i>,<i>fn</i>' where <i>fn</i> corresponds to a
<a href="#tmindex">Tibetan Machine font</a> and <i>ord</i> tells
which glyph in <b>Tibetan Machine</b> corresponds to the Tibetan
Machine Web glyph this line describes
</li>
<li>
Column 3 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to a
<a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web <b>reduced-height glyph</b> corresponding to the full-height
glyph this line describes
</li>
<li>
<b>Column 4 - key -</b> '<i>fn</i>,<i>ord</i>' where <i>fn</i>
corresponds to a <a href="#tmwindex">Tibetan Machine Web font</a>
and <i>ord</i> tells which Tibetan Machine Web glyph this line
describes.&nbsp; No two rows of data may have the same value for
Elaborated for developers. The code in question (TMW->ACIP for the TMW for U+0FAD) is not yet committed, but will be soon.
2004-04-11 14:14:49 +00:00
this column.&nbsp; (Note that TMW is a superset of TM, so there is
one glyph in TM that could reasonably appear twice, mapped to both
TibetanMachineWeb7.90 and TMW7.91.)&nbsp; <i>But note that Jskad
etc. must deal with a superset of TMW -- such as when converting
the ACIP {<tt>W+W+W+KA</tt>} into Unicode -- and thus cannot
internally use the TMW glyph alone to represent arbitrary Tibetan
text.&nbsp; And the Extended Wylie Transliteration is not a unique
key either; see, e.g., the many glyphs that EWTS
{<tt>r</tt>}.&nbsp; For this reason, a smart tool uses the pair
(EWTS,&nbsp;TMW) as an internal representation.&nbsp; (In Jskad,
this is done in a way that's hard to understand, but it is done --
see, e.g., the code implementing the TMW-&gt;ACIP conversion of
TibetanMachineWeb7.69.)</i>
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
</li>
<li>
Column 5 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to a
<a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web glyph for the <b>gi-gu</b> vowel that looks most beautiful
with the glyph this line describes
</li>
<li>
Column 6 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to a
<a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web glyph for the <b>zhabs-kyu</b> vowel that looks most beautiful
with the glyph this line describes
</li>
<li>
Column 7 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to a
<a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web glyph for the <b>'greng-bu</b> vowel that looks most beautiful
with the glyph this line describes
</li>
<li>
Column 8 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to a
<a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web glyph for the <b>na-ro</b> vowel that looks most beautiful
with the glyph this line describes
</li>
<li>
Column 9 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to a
<a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web glyph for the <b>a-chung</b> [Sanskrit] vowel that looks most
beautiful with the glyph this line describes
</li>
<li>
Column 10 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to
a <a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web glyph for the <b>a-chung plus zhabs-kyu</b> [Sanskrit] vowel
that looks most beautiful with the glyph this line describes
</li>
<li>
Column 11 - '<i>x<sub>1</sub></i>,<i>x<sub>2</sub></i>,...' or
'none', where <i>x<sub>i</sub></i> describes a Unicode codepoint,
most often a codepoint in the Tibetan range U+0F00 to
U+0FFF.&nbsp; A case-insensitive string of one, two, three, or
four hexadecimal digits composes each <i>x<sub>i</sub></i>.&nbsp;
The full, comma-separated sequence is the preferred Unicode
representation of the glyph this line describes; 'none' appears
for glyphs that have no Unicode correspondence.
</li>
<li>
Column 12 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to
a <a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web <b>severely-reduced-height glyph</b> corresponding to the
full-height glyph this line describes
</li>
<li>
Column 13 - '<i>fn</i>,<i>ord</i>' where <i>fn</i> corresponds to
a <a href="#tmwindex">Tibetan Machine Web font</a> and <i>ord</i>
tells which glyph in that font corresponds to the Tibetan Machine
Web <b>vowel+bindu glyph</b> corresponding to the vowel glyph this
line describes
</li>
</ul>
<a name="tmindex"></a>
<h4>Tibetan Machine Font Indices</h4>
<p>
The following are the indices this file format uses to refer to the
TibetanMachine font files:
</p>
<ul>
<li>
1 corresponds to TibetanMachine, the normal font
</li>
<li>
2 corresponds to TibetanMachineSkt1
</li>
<li>
3 corresponds to TibetanMachineSkt2
</li>
<li>
4 corresponds to TibetanMachineSkt3
</li>
<li>
5 corresponds to TibetanMachineSkt4
</li>
</ul>
<a name="tmwindex"></a>
<h4>Tibetan Machine Web Font Indices</h4>
<p>
The following are the indices this file format uses to refer to the
TibetanMachineWeb font files:
</p>
<ul>
<li>
1 corresponds to TibetanMachineWeb
</li>
<li>
2 corresponds to TibetanMachineWeb1
</li>
<li>
3 corresponds to TibetanMachineWeb2
</li>
<li>
4 corresponds to TibetanMachineWeb3
</li>
<li>
5 corresponds to TibetanMachineWeb4
</li>
<li>
6 corresponds to TibetanMachineWeb5
</li>
<li>
7 corresponds to TibetanMachineWeb6
</li>
<li>
8 corresponds to TibetanMachineWeb7
</li>
<li>
9 corresponds to TibetanMachineWeb8
</li>
<li>
10 corresponds to TibetanMachineWeb9
</li>
</ul>
<p>
Please
<a href="mailto:thdltools-devel@lists.sourceforge.net">
e-mail us</a>
your comments about this page.
</p>
<p>
The
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<a href="http://www.sourceforge.net/projects/thdltools">
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
THDL Tools</a>
project is generously hosted by:
<!--
DO NOT DELETE THE SF.NET LOGO.
We have a choice of colors and sizes for this logo (see
"https://sourceforge.net/docman/display_doc.php?docid=790&group_id=1"),
but we do not have the option of removing it. SourceForge requests
that we put it on each web page for our project, and to give us
incentive to do so, they will not track the number of hits for our
project web pages unless we put this link in. To track hits, see
"http://sourceforge.net/project/stats/index.php?report=months&group_id=61934".
-->
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
<a href="http://sourceforge.net/">
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
<img src="http://sourceforge.net/sflogo.php?group_id=61934&amp;type=1"
An attempt at bringing these pages up to date w.r.t. THDL HTML guidelines. I ran these through validator.w3.org; some validated; some didn't. <code> is legal, though, I swear.
2003-10-31 04:17:28 +00:00
width="88" height="31" alt="SourceForge Logo" />
Added docs for the tibwn.ini file format.
2003-07-12 16:39:23 +00:00
</a>
<!-- AGAIN, DO NOT DELETE THE SF.NET LOGO. -->
</p>
</div>
</body>
</html>
Reference in a new issue Copy permalink