Checklists
<h3 class="heading-h6"><a name="THLToolboxhomegtEssayssitec06fa8cfc49c4ebc007f482de5382105essaysgtTHLStaffDocumentationforXMLEssaysgtChecklists" class="anchorpoint"></a><a href="/tools/wiki/home.html">THL Toolbox</a> > <a href="/tools/wiki/essays.html">Essays</a> > <a href="/tools/wiki/THL%20Staff%20Documentation%20for%20XML%20Essays.html">THL Staff Documentation for XML Essays</a> > Checklists</h3><p class="paragraph">
</p><h3 class="heading-h1"><a name="ChecklistsandHelpfulTables" class="anchorpoint"></a>Checklists and Helpful Tables</h3><p class="paragraph"><strong class="bold">Contributor(s)</strong>: José Cabezón, Michael Cox, David Germano, Nathaniel Grove, Alison Melnick, Steven Weinberger.</p><p class="paragraph"><a name="top" class="anchorpoint"></a>
<table border="0" cellpadding="0" cellspacing="0" class="listHier lines"><tr><th scope="col"> </th><th scope="col"> </th><th scope="col"> </th><th scope="col"> </th></tr><tr class="table-odd"><td><strong class="bold"><a href="/tools/wiki/checklists.html#overview">Overview of Steps</a></strong></td><td><strong class="bold"><a href="/tools/wiki/checklists.html#check">Check Essay</a></strong></td><td><strong class="bold"><a href="/tools/wiki/checklists.html#search">Conduct a Search</a></strong></td><td><strong class="bold"><a href="/tools/wiki/checklists.html#markup">Markup Checklist</a></strong></td></tr><tr class="table-even"><td><strong class="bold"><a href="/tools/wiki/checklists.html#xml">Post XML Conversion</a></strong></td><td><strong class="bold"><a href="/tools/wiki/checklists.html#graph">Styles Graph</a></strong></td><td><strong class="bold"><a href="/tools/wiki/checklists.html#own">Your Own List</a></strong></td></tr></table></p><p class="paragraph"><a name="overview" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="AnOverviewofStepsforProcessinganIssueofJIATS" class="anchorpoint"></a>An Overview of Steps for Processing an Issue of JIATS</h3><p class="paragraph">For an overview of the process involved in publishing a JIATS article go to the <a href="/tools/wiki/journal%20submissions.html">Journal Submissions</a> page.</p><p class="paragraph"><em class="italic"><a href="/tools/wiki/checklists.html#top">Back to top</a></em></p><p class="paragraph"><a name="check" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="CheckEachAuthorsArticleFortheFollowing" class="anchorpoint"></a>Check Each Author’s Article For the Following:</h3><p class="paragraph">
</p><ol><li>Create entries in the Glossary Table for author and title of all entries in the Bibliography.</li>
<li>Make sure we have received the author’s abstract, bio, and photo with the article.</li>
<li>Make sure all Tibetan, Sanskrit, Mongolian, and Chinese words are entered correctly in the Glossary Table.</li>
<li>Make sure all Tibetan terms in the Glossary Table (and in parentheses in the article) are in THL Extended Wylie transliteration.</li>
<li>Make sure all Word Styles have been applied for bold, italic, indented citations, English language place names, and so forth.</li>
<li>Make sure that all bibliographic citations in the notes and bibliography conform to THL standards (see documentation for details).</li>
<li>Make sure the canonical texts have complete references, including citations of the catalogue name and volume number.</li>
<li>Change single quotes to double quotes, unless it’s a quote within a quote.</li>
<li>Change all quotes (single and double) to smart quotes. Make sure single quote that represents the <em class="italic">a chung</em> in Wylie is a close single quote (’ = apostrophe) and not an open single quote (‘).</li>
<li>Change double dash to en dash (make sure there is a space both before and after the en dash), <strong class="bold">except for</strong> hyphens.</li>
<li>In Bibliographies, use a 3em dash (that is, three consecutive em dashes) for repeat author entry (do NOT use multiple single dashes or underscores).</li>
<li>For passages in Tibetan, Sanskrit, Mongolian, or Chinese, enter the translation in the body of the essay itself and place the Tibetan/Sanskrit/Mongolian/Chinese in a footnote/endnote.</li>
<li>All punctuation, including periods and commas, always go <em class="italic">inside</em> a close quotation mark. The only exceptions are: semi-colon ( ; ), colon ( : ), and en dash (–).</li>
<li>Footnote/endnote numbers always <em class="italic">follow</em> all punctuation marks (including colons), except for the en dash (–), which the footnote/endnote number precedes.</li>
<li>Make sure that all numbers conform to THL conventions.</li>
<li>Apply proper formatting for headers.</li>
<li>Make sure there are captions for each image, table, chart, or video clip. This is especially important because the markup for these media will be added after XML conversion.</li>
<li>Make sure there are no extra carriage returns (created by hitting the “enter” key) in the essay, and in particular between paragraphs. These will create huge unwanted spaces between paragraphs when the article is posted online.</li>
<li>If you have questions, refer to articles in previous issues of JIATS for examples.</li></ol><ol><li>Make sure the metadata table is filled out and all Word paragraph styles are applied to the essay Word doc before conversion:<ol><li>the h1 front, h1 body, and h1 back Word styles</li>
<li>the normal Word style to the body of the essay</li>
<li>citation prose, etc. where necessary</li>
<li>Footnote text,ftxt to ALL footnotes.</li>
<li>Bibliographic entry,be to ALL entries in the Bibliography section at the end of the essay.</li></ol></li></ol><p class="paragraph"><em class="italic"><a href="/tools/wiki/checklists.html#top">Back to top</a></em>
<a name="search" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="SearchfortheFollowing" class="anchorpoint"></a>Search for the Following:</h3><p class="paragraph">After all corrections, etc. have been made to the XML file, run the following searches in the browser's find function:
</p><ol><li>.. (two periods in a row);</li>
<li>,, (two commas)</li>
<li>”. (remember that you have to search on smart quotes or it won’t find them)</li>
<li>”,</li>
<li>’.</li>
<li>’,</li>
<li>)s</li>
<li>)es</li>
<li>)ies</li>
<li>)”</li>
<li>.).</li>
<li> . (space and then a period)</li>
<li> , (space and then a comma)</li>
<li> ; (space and then a semi-colon)</li>
<li> : (space and then a colon)</li>
<li>( + space</li>
<li>space + )</li>
<li>[[</li>
<li>]]</li>
<li>[ [</li>
<li>] ]</li>
<li>((</li>
<li>( (</li>
<li>))</li>
<li>) )</li>
<li>[ (</li>
<li>) ]</li>
<li>. [ (note: this is mainly to find spaces before a note)</li></ol><p class="paragraph"><em class="italic"><a href="/tools/wiki/checklists.html#top">Back to top</a></em></p><p class="paragraph"><a name="glossary" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="GlossaryTableChecklist" class="anchorpoint"></a>Glossary Table Checklist</h3><p class="paragraph">
</p><ol><li>Make sure each single quote that represents the a chung in Wylie is a close single quote (’= apostrophe) and <strong class="bold">not</strong> an open single quote (‘).</li>
<li>Remove any English-language pluralizers and possessives from the Glossary Table. For example, if the author refers to “thu’u bkwan’s <em class="italic">Crystal Mirror</em>,” make sure that in the Glossary Table the name appears as “thu’u bkwan” and <strong class="bold">not</strong> “thu’u bkwan’s”.</li>
<li>Capitalize English translations of proper nouns (text titles, names of temples, and so forth). Example: the translation of of lha sa gtsug lag khang in the Glossary Table is Central Temple of Lhasa.</li>
<li>Remove any capitalizations that should not occur in Wylie, Sanskrit, and so forth.</li>
<li>Make sure all available information is included for each entry.</li></ol><p class="paragraph"><em class="italic"><a href="/tools/wiki/checklists.html#top">Back to top</a></em>
<a name="xml" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="PostXMLConversionChecklist" class="anchorpoint"></a>Post-XML Conversion Checklist</h3><p class="paragraph">
After an essay has been converted to XML:</p><ol><li>Make sure that all quotations have remained intact in the conversion process, and that none are missing.</li>
<li>Check to make sure there the same number of footnotes appear in the post-conversion version of the article as in its original Word document.</li>
<li>Check to make sure every paragraph in the Word document has also made it into the xml file.</li>
<li>Check all ’s, s, s’ after foreign words and proper nouns to make sure they are not marked up as part of a foreign word or term, and that when the English translation is plural it is correct (for example, that it reads “monasteries” and not “monasterys”).</li>
<li>Check the English indefinite articles “a” and “an” before foreign-language words in the Glossary Table: make sure the correct article is used for the English translation, since this will immediately follow the indefinite article. <strong class="bold">XML Example:</strong> This will display online as: “This title was used for an <term lang="eng">emperor</term> (<term lang="tib">btsan po</term>).” Word doc: This title was used for an btsan po.</li>
<li>Check that <persName>s that include <surname>, <foreName> components have the correct markup. These will probably have to be fixed by hand in the XML file.</li>
<li>In the glossary.xml file, change all date ranges to the full range. For example, change “1357-78” to “1357-1378” <strong class="bold">Note:</strong> this only applies to the glossary.xml file. Do <strong class="bold">not</strong> make this type of change in the essay itself.</li>
<li>Check the Word doc against the XML file to make sure that all formatting (such as indented quotes, indented verse, and the like) are marked up as they were pre-conversion.</li>
<li>If there were English translations of glossary table words that appeared in quotation marks in the original, adjust these so they display identically to the original article.</li>
<li>When there is more than one English translation for a single foreign-language word, make sure that the markup and display is correct in the body of the article after it has been converted to XML.</li>
<li>If there were any terms in the glossary table that are also included in English words (for example, the place name “mon”), go through the article and make sure that parts of English words have not accidentally been marked up. So, if the place name “mon” appears in the article, go through and make sure that all instances of “monastery” are not split up with the markup for “mon.”</li>
<li>If a Tibetan word is the first in a sentence, these must be capitalized by hand after conversion.</li>
<li>Search for "the the" and delete where necessary.</li>
<li>Search for (( and remove doubled up English translations of terms.</li></ol><p class="paragraph"><em class="italic"><a href="/tools/wiki/checklists.html#top">Back to top</a></em>
<a name="markup" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="MarkupChecklist" class="anchorpoint"></a>Markup Checklist</h3><p class="paragraph">For an exhaustive list of Word styles (to be used in the Word document itself or in the glossary table) and examples of their XML markup, go to the <a href="/tools/wiki/Staff%20Instructions%20for%20the%20Glossary%20Table.html">Staff Instructions for the Glossary Table</a> page.</p><p class="paragraph"><em class="italic"><a href="/tools/wiki/checklists.html#top">Back to top</a></em>
<a name="own" class="anchorpoint"></a>
</p><h3 class="heading-h2"><a name="YourOwnLists" class="anchorpoint"></a>Your Own List(s)</h3><p class="paragraph">
While marking up an essay, you might come across issues that require you to: ask questions of Steve or the essay's author, check that certain tricky things have converted properly, make sure photos are placed correctly, and so forth. Keep a list of all of these things in a separate Word document while you are marking up each essay so that you can refer back to it once you have finished marking up the essay.</p><p class="paragraph"><em class="italic"><a href="/tools/wiki/checklists.html#top">Back to top</a></em>
<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></p>