Page Numbers Of Original Editions
<h3 class="heading-h6"><a name="THLToolboxhomegtDevelopersZonegtXMLMarkupinTHLgtPageNumbersofOriginalTexts" class="anchorpoint"></a><a href="/tools/wiki/home.html">THL Toolbox</a> > <a href="/tools/wiki/Developers%27%20Zone.html">Developers' Zone</a> > <a href="/tools/wiki/XML%20Markup%20in%20THL.html">XML Markup in THL</a> > Page Numbers of Original Texts</h3><p class="paragraph">
</p><h3 class="heading-h1"><a name="MilestonesandPageNumbersofOriginalTexts" class="anchorpoint"></a>Milestones and Page Numbers of Original Texts</h3><p class="paragraph">For an XML document that represents a physical text or, as with JIATS, one that has a PDF equivalent which delineates putative page-breaks, the page boundaries are marked up with the <milestone /> element. This element is an empty element that contains no text or children but is self closing. (That is, instead of their being a pair of tags (an opening and closing tag), it is a single tag that ends with the closing "/>") Because Tibetan proper nouns have two display forms (scholarly extended Wylie transliteration) and easily readible phonetics, a special form of markup is used when the page or line break occurs within a Tibetan proper noun. See the <a href="/tools/wiki/page%20numbers%20of%20original%20editions.html#exception">description of this exception below</a>.
</p><h3 class="heading-h2"><a name="Summary" class="anchorpoint"></a>Summary</h3><p class="paragraph">
</p><ul class="star"><li><strong class="bold">Element:</strong> <milestone /></li>
<li><strong class="bold">Use:</strong> placed at the location in the text where a new page or line begins</li>
<li><strong class="bold">Attributes:</strong><ul class="star"><li><strong class="bold">unit:</strong> the unit being recorded by the milestone, usually "page" or "line"</li>
<li><strong class="bold">ed:</strong> identifies to the edition or text being referred to, this is especially used when two kinds of milestones are being used such as when a JIATS article (that has its own page breaks) contains a transliteration of a text with embedded page breaks.</li>
<li><strong class="bold">n:</strong> (optional) the number of the page or line being recorded. In JIATS articles, this is not included with the page milestones the number of which is determined by the number of preceding milestones.</li>
<li><strong class="bold">rend:</strong> values for determining how the milestone is rendered. Values are:<ul class="star"><li> "ownline" displays page or line number on its own line</li>
<li>"indent" indents the line before displaying the number</li></ul></li></ul></li></ul><p class="paragraph">The general display of a milestone is within square brackets the unit and its number such as "page 4" but in digital texts no unit is given only the page and line such as "8a" or "14b.3".
</p><h3 class="heading-h2"><a name="Examples" class="anchorpoint"></a>Examples</h3><p class="paragraph"><strong class="bold">JIATS example of Article's Page Break:</strong></p><div class="code"><pre>… with fecal analysis of bear <milestone unit=<span class="java-quote">"page"</span>/>droppings in the mid-1990s …</pre></div><p class="paragraph">
<strong class="bold">JIATS example of Transciption of text contained within an Article</strong>:
</p><div class="code"><pre><p><milestone ed=<span class="java-quote">"IOL"</span> unit=<span class="java-quote">"panel"</span> n=<span class="java-quote">"1"</span> rend=<span class="java-quote">"ownline"</span>/><milestone ed=<span class="java-quote">"IOL"</span> unit=<span class="java-quote">"line"</span> rend=<span class="java-quote">"indent"</span> n=<span class="java-quote">"1"</span>/>༆། །རང་བཞིན་</pre></div><p class="paragraph"><strong class="bold">Digital Tibetan Text Example:</strong> (From Dege Kangyur text)</p><div class="code"><pre>… །ཚུལ་ཁྲིམས་འཆལ་པས་<milestone unit=<span class="java-quote">"page"</span> n=<span class="java-quote">"2a"</span> /><milestone unit=<span class="java-quote">"line"</span> n=<span class="java-quote">"2a.1"</span> />ཟིན་རྣམས་ཀྱི། …</pre></div><p class="paragraph"><a name="exception" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="MilestonesthatFallwithinanElementthatHasBothPopularandScholarlyViews" class="anchorpoint"></a>Milestones that Fall within an Element that Has Both Popular and Scholarly Views</h3><p class="paragraph">When a milestone page-break falls within any element such as a persName, title, etc. that has different popular and scholarly views, special markup is needed. The element containing the markup is inserted twice once for each view with the popular view using <pg rend="milestone"/> to mark the location of the break. This pair of elements is then wrapped in a third element of the same name with type set equal to "views". Thus,</p><div class="code"><pre><title type=<span class="java-quote">"views"</span>>
  <title level=<span class="java-quote">"m"</span> lang=<span class="java-quote">"tib"</span> n=<span class="java-quote">"s"</span>>rin po che snang gsal spu gri <milestone unit=<span class="java-quote">"page"</span>/>’bar bas ’khrul snang rtsad nas gcod pa nam mkha’i mtha’ dang mnyam pa’i rgyud</title>
  <title level=<span class="java-quote">"m"</span> lang=<span class="java-quote">"tib"</span> n=<span class="java-quote">"p"</span>>Rinpoché Nangsel Pudri <pb rend=<span class="java-quote">"milestone"</span>/>Barwé Trülnang Tsené Chöpa Namkhé Ta Dang Nyampé Gyü</title>
</title></pre></div><p class="paragraph">The same is done for other elements <persName> etc.
</p><h3 class="heading-h6"><a name="ProvidedforunrestrictedusebythespanclassnobrimgsrcsakairwikitoolimagesicklearrowgifaltexternallinktitleexternallinkahrefhttpwwwthliborgtargetrwikiexternalTibetanandHimalayanLibraryaspan" class="anchorpoint"></a><em class="italic">Provided for unrestricted use by the <span class="nobr"><img src="/" alt="external link: " title="external link"/><a href="http://www.thlib.org" target="rwikiexternal">Tibetan and Himalayan Library</a></span></em></h3>