The Tibetan and Himalayan Library

Images In Xml Essays

<h3 class="heading-h6"><a name="THLToolboxhomegtDevelopersZonegtXMLMarkupinTHLgtImagesinXMLEssays" 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> > Images in XML Essays</h3> <h3 class="heading-h1"><a name="ImagesinXMLEssays" class="anchorpoint"></a>Images in XML Essays</h3>Contributor(s): Than GroveIn THL XML essays, the markup of images uses the <figure> element in TEI. The simplest figure tag is an empty tag that has two attributes, an "entity" attribute and a "rend" attribute. The entity attribute contains the name of an image entity declared at the top of the document and the rend attribute contains a predefined value for the alignment of the image. The rend attribute is actually optional and default to right justification of the image. The rend attribute can have the following values:<ul class="star"><li>left (float left allowing text to appear to the right of the image)</li> <li>center (center the image in its own block, no text to either side)</li> <li>right (float right allowing text to appear to the right of the image)</li> <li>block (align left taking up the whole width of the article and not allowing text to appear to the right of the image)</li> <li>noshadow (also align left as "block" but without the custom drop shadow styling)</li> <li>inline (an inline image, usually smaller in size)</li></ul>The simplest figure tag would thus look like this:<div class="code"><pre><figure entity="img07b" rend="right"/></pre></div>Where the entity "img07b" is defined at the top of the document as:<div class="code"><pre><!ENTITY img07b SYSTEM "http://www.thlib.org/static/reprints/jiats/04/images/jiats04fox-img07b-sm.jpg" NDATA JPG></pre></div> <h3 class="heading-h2"><a name="Captions" class="anchorpoint"></a>Captions</h3>To include captions for an image, the <figDesc> child is included within the <figure> tag with the text of the caption inside it. This <figDesc> element can contain internal markup, plain text, or a combination of both. Thus, for an image with a caption the markup would look like:<div class="code"><pre><figure entity="img01" rend="block"> <figDesc>Figure 1. Nomad herder’s camp at about five-thousand meters elevation in the northern <geogName type="lake"><name type="lake" corresp="entry19" lang="tib" n="Aru">a ru</name> <geog>Basin</geog></geogName>, <placeName corresp="entry11" lang="eng">Rutok County</placeName>, <placeName corresp="entry13" lang="eng">Ngari Prefecture</placeName>, within the <placeName><geogName corresp="entry1" lang="tib" n="Jangtang">byang thang</geogName> Nature Reserve</placeName> on the western <geogName>Tibetan Plateau</geogName>. Photo: Joseph Fox </figDesc> </figure></pre></div>Note: For side-by-side images (see below) with a single caption, the <figDesc> element should be given a rend="fullwidth". <h3 class="heading-h2"><a name="Morethanoneimagesidebyside" class="anchorpoint"></a>More than one image side by side</h3>When one wants to place two or more images side by side in a row, special mark-up is required. One needs to place the individual figure tags within an element whose rend attribute is set to "imgs". To ensure the proper positioning of two images, the first figure is given a rend="left" and the second rend="right". As mentioned above, when there is a single caption for both images the <figDesc> element is given a rend="fullwidth". Thus, the markup of such a situation is exemplified by:<div class="code"><pre>"imgs"> <figure entity="img06a" rend="left"> <figDesc rend="fullwidth">Figure 6. Fencing constructed in 2005 to delineate herding group grazing boundaries at around 4,800-meter elevation in the northernmost inhabited areas of <placeName corresp="entry15" lang="eng">Drakpo Township</placeName>, <placeName corresp="entry5" lang="eng">Gertsé County</placeName>, <placeName corresp="entry13" lang="eng">Ngari Prefecture</placeName>, within the <placeName><geogName corresp="entry1" lang="tib" n="Jangtang">byang thang</geogName> Nature Reserve</placeName>. Photos: Joseph Fox </figDesc> </figure> <figure entity="img06b" rend="right"/> </pre></div> <h3 class="heading-h2"><a name="SmallVersusLargeImages" class="anchorpoint"></a>Small Versus Large Images</h3>The normal display mode for images is to present a smaller version of the image within the body of the essay that itself is clickable. Clicking on one of these smaller images produces a popup window displaying a larger version of the image. This mechanism is automatically invoked base on the filename of the image declared in the entity definition at the top of the document. In the example above, the filename within the entity is:<div class="code"><pre>… SYSTEM "http://www.thlib.org/static/reprints/jiats/04/images/jiats04fox-img07b-sm.jpg" …</pre></div>The "-sm" suffix to this file name "jiats04fox-img07b-sm.jpg" indicates that it is a smaller version and invokes the code to create the popup. For maps, charts, and so forth that should be readable within the text itself without requiring a popup, one simply does not include the "-sm" within the name of the file and uses a URL that points to a large version of the image. The markup of the image and its caption is the same as described above, but the lack of the "-sm" suffix to the file name prevents the popup from being invoked. <h3 class="heading-h6"><a name="ProvidedforunrestrictedusebythespanclassnobrimgsrcsakairwikitoolimagesicklearrowgifaltexternallinktitleexternallinkahrefhttpwwwthliborgtargetrwikiexternalTibetanandHimalayanLibraryaspan" class="anchorpoint"></a>Provided for unrestricted use by the <img src="/" alt="external link: " title="external link"/><a href="http://www.thlib.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