The Tibetan and Himalayan Library

Checking Converted Bibliographic Records

<h3 class="heading-h6"><a name="THLToolboxhomegtTibetanTextsgtCatalogingaTibetanTextgtConvertingEntriesgtProofreadingConvertedBibliographicRecords" class="anchorpoint"></a><a href="/tools/wiki/home.html">THL Toolbox</a> > <a href="/tools/wiki/Tibetan%20Texts.html">Tibetan Texts</a> > <a href="/tools/wiki/Cataloging%20a%20Tibetan%20Text.html">Cataloging a Tibetan Text</a> > <a href="/tools/wiki/Converting%20Entries.html">Converting Entries</a> > Proofreading Converted Bibliographic Records</h3> <h3 class="heading-h1"><a name="ProofreadingConvertedXMLBibliographicRecords" class="anchorpoint"></a>Proofreading Converted XML Bibliographic Records</h3>Contributor(s): THL Staff.Once the bibliographic records have been converted into XML files, they need to be checked and cleaned up. This involves the following tasks:<ul class="star"><li>Opening up each XML record in an XML editor and making sure it validates against the DTD. If it does not, then correcting problems in the document until it validates, or else try reconverting.</li> <li>Looking at the bottom of the document for comments and notes left by the cataloger. Some of these comments may be information that needs to be entered into the XML as a note or discussion. All the cells in the third column of the entry table get converted into a comment at the bottom of the XML file. Each row's comment is preceded by the label in the first cell of the row, and the comments for different rows are separated by a row of asterisks. Some of the comments will be to add information in the markup, such as pagination for multi-volume texts. Others may be specific instructions to the converter or proofer, such as to check the accuracy of some information.</li> <li>Once a volume of XML records has been sufficiently cleaned-up, the entire volume should be zipped into a single file called N-Kg-v###-xml.zip and uploaded to that volume's folder in the Canons Resources page.</li></ul> <h3 class="heading-h3"><a name="MarkupforNotes" class="anchorpoint"></a>Markup for Notes</h3>Insert a <note> tag with the following attributes <note id="N-0004-bib-n1" resp="snw" type="translators"> <ul class="star"><li><ul class="star"><li>id: the name of the file with xml removed and replaced with n1 for the first note in the file, n2 for the second note in the file, etc.</li> <li> resp: your three-letter initials.</li> <li>type: the name of the tag to which this note refers. If the note is about the translators, then enter translators; if the note is about the colophon, then enter colophon; etc.</li> <li>Placement of note: insert the note just before the close tag of the section to which it refers (<note> is allowed in some places and not others, so you may have to experiment to find where it is allowed for a particular tag; keep a list of difficulties). For example, a note on the translators would go here: </li></ul></li></ul><div class="code"><pre><origination> <head>Provenance</head> <respdecl type="translator"> <persName n="Indian Scholar" lang="tib" key="">འཕགས་པ་གཞི་ཐམས་ཅད་ཡོད་པར་སྨྲ་བའི་འདུལ་བ་འཛིན་པ་ཁ་ཆེའི་བྱེ་བྲག་ཏུ་སྨྲ་བའི་སློབ་དཔོན་ཛི་ན་མི་ཏྲ།</persName> <persName n="Tibetan Translator" lang="tib" key="">ཞུ་ཆེན་གྱི་ལོ་ཙྪ་བ་བན་དེ་ཀླུའི་རྒྱལ་མཚན།</persName> </respdecl> <note id="N-0004-bib-n1" resp="snw" type="translators">This translator team was responsible for translating the first half of the text.</note> </origination></pre></div><ul class="star"><li>Correct problems that occurred with the Wylie to Unicode Tibetan conversion. In Tibetan fields there may occur phrases of Wylie in brackets in the middle of the Tibetan. These are chunks of Wylie that did not convert and need to be fixed. When this occurs it is usually in Sanskrit titles and is most often the result of incorrect THL Extended Wylie (such as forgetting to add a + between letters in non-standard stacks) in the Word doc. Much less frequently this results because the stack has not yet been created in Tibetan Machine Uni. Example: ཨཱ་[rya]་པ་ཉྩ་བི་[ngsha]་ཏི་ཀ་པྲ་ཛྙཱ་པཱ་ར་མི་ཏཱ་མུ་ཁ་ནཱ་མ་མ་ཧཱ་ཡཱ་ན་སཱུ་ཏྲ། Solution: manually create ཪྱ and ངྴ and replace the Wylie (including the square brackets) with them. Also make the corresponding correction to the Wylie within the comment (<!<strike class="strike"> </strike>>) tag. Note: be sure there is only one tsheg between the text you correct and the syllable that follows it.</li></ul> <h3 class="heading-h3"><a name="MarkupforDiscussionPhysfacet" class="anchorpoint"></a>Markup for Discussion, Physfacet</h3>Data in the Word general discussion field dealing with page numbering issues should have the following XML markup:<div class="code"><pre><physfacet type="Distinctive features">Page 619 is misnumbered 618. (snw)</physfacet></pre></div>This goes in the XML file here:<div class="code"><pre><physfacet lang="tib" type="Script">  དབུ་ཅན། </physfacet> <physfacet type="Distinctive features">Page 619 is misnumbered 618. (snw)</physfacet></pre></div> <h3 class="heading-h2"><a name="MarkupIssues" class="anchorpoint"></a>Markup Issues</h3>The following list is one of various markup issues and how they are resolved in XML. These problems may result in the XML document not validating. So, if your document doesn't validate, check the list below. (It will gradually get longer as further questions come up.) <h3 class="heading-h4"><a name="MasterIDIssues" class="anchorpoint"></a>Master ID Issues</h3>(problem with Narthang Converter prior to 3/26/2007): the Master ID #, which in the Canons Project is garnered from Phil Stanley's database, is marked up in an <idno> element that follows immediately after the <tibid> … </tibid> that provides unique identification information for that version of that text, preceding any other <idno> that is recorded in the Tibbibl record. The idno element must have a type attribute set to "master". Thus, in the Kangyur it would appear as follows:<div class="code"><pre>… </tibid> <idno type="master">0014</idno> <idno type="eimer">14</idno></pre></div>Note: In versions of the Narthang converter that pre-dated 3-26-2007, this information was dropped. Any records converter prior to that date should be checked and the information entered by hand. The information can be found in the Kangyur and Tengyur Title lists. <h3 class="heading-h4"><a name="TextsSpanningMultipleVolumes" class="anchorpoint"></a>Texts Spanning Multiple Volumes</h3>About 60 texts span multiple volumes. In such cases, the cataloger will insert references to the ending volume in the third column. This will create notes in the comment at the end of the XML document, which will need to be converted by hand into XML, according to these instructions: <ul class="star"><li>volume information: this markup follows the comment "VOLUME INFO" and looks like this:</li></ul><div class="code"><pre> <tibid type="volume" system="number">24 <altid system="letter" lang="tib">ང</altid> <tibid type="text" system="number">3</tibid> </tibid></pre></div><tibid type="volume"> is the sequential volume number within the edition and is the means for connecting to the volume bibliographic record; in this example, it is the 24th volume in the edition. The letter ID (<altid system="letter">) generally restarts with each genre and therefore is not unique; it is included for reference purposes. In this example, it is the fourth volume of the genre. The text number (<tibid type="text">) refers to the number of the text within the volume; in this example, the text is the third text in the volume.When a text begins in one volume and ends in another volume, this markup should be repeated for each volume. Assign an "n" attribute to each <tibid type="volume"> tag, indicating which volume it is in the sequence of the volumes that contain this text: "n="1" indicates the first volume in which the text occurs; n="2" indicates the second volume in which the text occurs; n="3" indicates the third volume in which the text occurs; etc. You also need to enter this number in the VOLUME INFO comment. Example: for a text the beginning of which is the third text in volume 24 and which ends as the first text in volume 26, the markup would be:<div class="code"><pre> <tibid type="volume" system="number" n="1">24 <altid system="letter" lang="tib">ང</altid> <tibid type="text" system="number">3</tibid> </tibid>  <tibid type="volume" system="number" n="2">25 <altid system="letter" lang="tib">ཅ</altid> <tibid type="text" system="number">1</tibid> </tibid>  <tibid type="volume" system="number" n="3">26 <altid system="letter" lang="tib">ཆ</altid> <tibid type="text" system="number">1</tibid> </tibid></pre></div><ul class="star"><li>pagination and extent: these will need to be modified for texts that span multiple volumes. The standard markup for the page range of a text is:</li></ul> <div class="code"><pre><pagination type="block"> <num n="begin">262b.1</num> <num n="end">645b.7</num> </pagination></pre></div>For multi-volume texts, there needs to be a list of page ranges for each volume. This is achieved by wrapping each pair of beginning and ending <num> elements within a parent <num> element whose type attribute is set to "volume" and whose n attribute is set to the number of the volume within the sequence of volumes in which the text occurs, as follows:<div class="code"><pre><pagination type="block"> <num n="1" type="volume"> <num n="begin">262b.1</num> <num n="end">653b.7</num> </num> <num n="2" type="volume"> <num n="begin">1a.1</num> <num n="end">703b.7</num> </num> <num n="3" type="volume"> <num n="begin">1a.1</num> <num n="end">453a.3</num> </num> </pagination></pre></div>Here, <num n="1" type="volume"> indicates that this is the pagination of the text in the volume in which the text begins; <num n="2" type="volume"> indicates that this is pagination of the text within the second volume in which it occurs; etc.As for the extent of the text, this will have to be calculated by adding up all the paginations (full or partial) for each volume into a total number of sides. This figure should be correct if the cataloger added all the sides of the volumes other than the first volume and entered this figure in the page "differential field" of the Word entry form. In the XML file there should be a note associated with the "page differential" field indicating how the figure in the "page differential" field was calculated. <h3 class="heading-h4"><a name="PaginationIssues" class="anchorpoint"></a>Pagination Issues</h3>Most paginations go within a tag by the same name. However, in a few situations the <source> element is used. In either case, there are two types of paginations that are marked up slightly differently: <ul class="star"><li>if an item falls within a single page and line, that page and line reference simply goes within the pagination element, as in:</li></ul> <div class="code"><pre><pagination n="bound">262b.2</pagination></pre></div> <ul class="star"><li>a page range is marked up as two <num> elements within the parent pagination element, as follows:</li></ul><div class="code"><pre><pagination type="block"> <num n="begin">262b.1</num><num n="end">264a.4</num> </pagination></pre></div>Note: this differs from how paginations are entered in the Word entry form (e.g., "262b.1-264a.4"). The converter eliminates the dash and adds the markup. <h3 class="heading-h4"><a name="ProvenanceIssues" class="anchorpoint"></a>Provenance Issues</h3>Provenance refers to the people who were involved in creating the artifact (text) being cataloged, from the author to the printer of the particular edition and all those in between, as well as other data about its creation such as the place, date, etc. In the Tibbibl markup, this information is wrapped in <origination> … </origination> tags that contain <respDecl>. The issues below deal with this section of the markup.<ul class="star"><li>empty provenance ("origination") will not validate: if there is no colophon information for a text, there will be no "origination" (provenance) information either. This will make the resulting XML file NOT validate because it will contain an empty origination element that will look like this:</li></ul><div class="code"><pre><origination> <head>Provenance</head> </origination></pre></div>If you delete this markup, then the XML will validate.Furthermore, since this means there is no colophonic information, the markup for the colophon should also be deleted. It looks like:<div class="code"><pre><physdecl rend="Colophon" n="colophon"> <head>Colophon</head> <discussion type="Colophon" n="contents" lang="tib"></discussion> <pagination type="Colophon" n="block"/> </physdecl></pre></div>If the tags are empty as above, they should be deleted. If you have any questions, contact Steve or Than. <h3 class="heading-h4"><a name="AdditionsMadetotheTibetanTextafterOriginalCarving" class="anchorpoint"></a>Additions Made to the Tibetan Text after Original Carving</h3>When an addition has been made to a Tibetan text – indicated by three or four dots that connect the inserted material to the place it was omitted, much like an annotation – the cataloger will add the XML markup below in the Word doc. The proofreader needs to check this to make sure it is correct. An example of this from a Tibetan text is:<img src="https://collab.itc.virginia.edu/access/content/group/c06fa8cf-c49c-4ebc-007f-482de5382105/THDL%20Toolbox%20Images/inserted-text.bmp" alt="Screen shot of material added to a Tibetan text" title="Screen shot of material added to a Tibetan text" border="0"/>In the bottom line, a smaller མ was added below and slightly to the left of the regular-sized མ probably because the second མ was mistakenly omitted when the block was originally carved. If this represented the ligature མྨ་ then there would not be space between the two letters and they would be directly above/below each other. Markup:<div class="code"><pre>ནཱ་མ་<add place="infralinear" resp="editor">མ་</add>ཧཱ་ཡཱ་ན་…</pre></div>In the unlikely event that you know the name of the person responsible for making the addition to the Tibetan text, enter that rather than "editor." Also, select the value of the place attribute from the following list: inline addition is made in a space left in the witness by an earlier scribe supralinear addition is made above the line infralinear addition is made below the line left addition is made in left margin right addition is made in right margin top addition is made in top margin bottom addition is made in bottom margin opposite addition is made on opposite page verso addition is made on verso of sheet mixed addition is made somewhere, one or more of other values <h3 class="heading-h3"><a name="IndividualDataFields" class="anchorpoint"></a>Individual Data Fields</h3>non-tib title in tibetan: if there is no non-Tibetan title given in the text, the cataloger will enter Not specified. In this case, make sure that lang="eng". The XML for such cases looks like this:<div class="code"><pre><title lang="eng" type="nontibet">Not specified.</title></pre></div>original language: if there is no original language specified in the text, the cataloger will enter Not specified. In this case, make sure that lang="eng". The XML for such cases looks like this:<div class="code"><pre><note type="original language" lang="eng" place="unspecified" anchored="yes">  Not specified.</note></pre></div>If there are multiple original languages, just make two different <titlediv> fields, nested within the <titleinfo> and <titlegrp> fields, and fill out the appropriate information for both languages. Change the <titlediv subtype=""> for the new language as well. Here is an example using Sanskrit and <img src="/" alt="external link: " title="external link"/><a href="http://babelstone.blogspot.com/2007/05/zhang-zhung-scripts.html" target="rwikiexternal">bru zha</a>:<div class="code"><pre><titlediv type="nontibet" subtype="sanskrit" lang="san"> <titledecl> <title lang="tib" type="nontibet">ས་རྦ་ཏ་ཐཱ་ག་ཏ་ཙི་ཏ་ཏ་ཛྙཱ་ན་གུ་ཧྱ་རྠ་ག་རྦྷ་བཱུ་ཧ་བཛྲ་ཏནྟྲ་སི་དྡྷི་ཡོ་ག་ཨ་ག་མ་ས་མཱ་ཛ་ས་རྦ་བི་དྱ་སཱུ་ཏྲ་མ་ཧཱ་ཡཱ་ན་ས་བྷི་ས་མ་ཡ་དྷ་རྨ་པ་རྱ་ཡ་བི་བྱཱུ་ཧ་ནཱ་མ་སཱུ་ཏྲཾ།</title> <title lang="san" type="nontibet">sarbatathāgatacitatajñānaguhyarthagarbhabūhabajratantrasiddhiyogaagamasamājasarbavidyasūtramahāyānasabhisamayadharmaparyayavibyūhanāmasūtraṃ</title> <title type="normalized" lang="san">sarvatathāgatacittajñānaguhyārthagarbhavyūhavajratantrasiddhiyogāgamasamājasarvavidyāsūtramahāyānābhisamayadharmaparyāyavivyūha-nāma-sūtra</title> <note type="original language" lang="tib" place="unspecified" anchored="yes">རྒྱ་གར་སྐད།</note> </titledecl> <pagination> <num n="begin">120b.4</num> <num n="end">120b.5</num> </pagination> </titlediv> <titlediv type="nontibet" subtype="bru zha"> <titledecl> <title lang="tib" type="nontibet">ཧོན་པ་ནི་རལ་ཏིལ་པི་བུ་བི་ཏིལ་ཏི་ཏ་སིང་འུན་འུབ་ཧང་པང་རིལ་ལ་འུབ་པི་སུ་བང་རི་ཞེ་ཧལ་པའི་མ་ཀྱང་གུའི་དང་རོད་ཏི།</title> <note type="original language" lang="tib" place="unspecified" anchored="yes">བྲུ་ཞའི་སྐད།</note> </titledecl> <pagination> <num n="begin">120b.5</num> <num n="end">120b.6</num> </pagination> </titlediv></pre></div>Author's Colophon: As with all chapter-level elements, an author’s colophon is marked by <div2> tags. They are distinguished by their type attributes. Thus, the author’s colophon is marked by <div2 type= "author's colophon"> tags. <h3 class="heading-h6"><a name="ProvidedforunrestrictedusebythespanclassnobrimgsrcsakairwikitoolimagesicklearrowgifaltexternallinktitleexternallinkahrefhttpwwwthdlorgtargetrwikiexternalTibetanandHimalayanLibraryaspan" class="anchorpoint"></a>Provided for unrestricted use by the <img src="/" alt="external link: " title="external link"/><a href="http://www.thdl.org" target="rwikiexternal">Tibetan and Himalayan Library</a></h3>

THL Home	About Us THL Overview First-Time Visitors Guide to Resources How to Cite Help Participation & Support Sponsors Status Reports THL URLs Contact Us
Collections	Multimedia Audio & Video Archive Images Maps Texts
Reference	Bibliographies Finding Aids Knowledge Maps Place Dictionary Transliteration Tibetan Dictionary Tibetan Translation Tool Tibetan-Phonetics Converter Tibetan-Wylie Converter
Places	Cultural Geography Interactive Map Maps Nepal Census Data Place Dictionary
Literature	Tibetan Canons Kangyur/Tengyur Collected Tantras of the Ancients Dilgo Khyentsé Catalog Literary Genres
Community	Social Connections Blogs Collaboration Worksites Communication Discussion Forums Events Mailing Lists THL Partners Tibetan News
Tools	Toolbox Prep Computer Software Technologies THL Research Lab Fonts:(Chinese Diacritics Nepali Tibetan )
Projects	Antiquities of Zhangzhung Drepung Monastery JIATS Meru Nyingpa Monastery Sera Monastery Projects Inventory Status Reports

THL Home	About Us THL Overview First-Time Visitors Guide to Resources How to Cite Help Participation & Support Sponsors Status Reports THL URLs Contact Us
Collections	Multimedia Audio & Video Archive Images Maps Texts
Reference	Bibliographies Finding Aids Knowledge Maps Place Dictionary Transliteration Tibetan Dictionary Tibetan Translation Tool Tibetan-Phonetics Converter Tibetan-Wylie Converter
Places	Cultural Geography Interactive Map Maps Nepal Census Data Place Dictionary
Literature	Tibetan Canons Kangyur/Tengyur Collected Tantras of the Ancients Dilgo Khyentsé Catalog Literary Genres
Community	Social Connections Blogs Collaboration Worksites Communication Discussion Forums Events Mailing Lists THL Partners Tibetan News
Tools	Toolbox Prep Computer Software Technologies THL Research Lab Fonts:(Chinese Diacritics Nepali Tibetan )
Projects	Antiquities of Zhangzhung Drepung Monastery JIATS Meru Nyingpa Monastery Sera Monastery Projects Inventory Status Reports

Tibetan and Himalayan Library - THL

Search

Toolbox Home

THL Toolbox

About Tools

General Links

THL Home

THL Apps

THL Navigation

THL Information

THL Connections

Upcoming Events

Subscribe: THL Updates

Support: Donate to THL

THL Help