How to annotate and present areas of interest in an image
This is a recipe for annotating and presenting an image with TEI/TILE-compliant text.
image file (see X for converting TIFF to JPG)
associated TEI/TILE-compliant text about the image
1. Open up the TEI/TILE-compliant file with a text editor.
2. Add line elements for the text of each annotation. Follow this model:
<pb facs=”#idforfirstimage” />
<lb/>
<l>Something of Interest 1</l>
<lb/>
<l>Something of Interest 2</l>
…
3. Use importer script for bringing text commentary into TILE workspace. Use this model:
/TILE/importWidgets/importXML.php?uri=http://<server>/TILE/importWidgets/impo ... for TEI XML>&rname=text&rnum=0&ipath=<Full path to image folder>
4. Go to a page [Image/Map/etc.].
5. Select an annotation and mark its area(s) of interest using the shape tools provided.
6. Repeat 4-5 as necessary until all annotations on every page are complete.
7. Save your session (JSON data).
7b. For archival purposes, Export to XML
Examples:
Here’s a TEI file
<?xml version="1.0" encoding="UTF-8"?>
<?oxygen RNGSchema="..//tei_all.rng" type="xml"?>
<?xml-stylesheet type="text/css" href="tei-11-08-08.css"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader></teiHeader>
<facsimile>
<surface xml:id="ham-1611-22277x-bod-c01-image001"><desc>Image 001</desc><graphic url="promontorymoc.png"/></surface>
<surface xml:id="ham-1611-22277x-bod-c01-image002"><desc>Image 002</desc><graphic url="rockart.png"/></surface>
<surface xml:id="ham-1611-22277x-bod-c01-image003"><desc>Image 003</desc><graphic url="DeneYeniseianMap.png"/></surface>
</facsimile>
<text>
<pb facs="#ham-1611-22277x-bod-c01-image001" />
<lb/>
<l>Semi-circular puckered vamp</l>
<lb/>
<l>quill work</l>
<lb/>
<l>grass-lining</l>
<pb facs="#ham-1611-22277x-bod-c01-image002" />
<lb/>
<l>Funky Shoulders</l>
<lb/>
<l>Spear</l>
<pb facs="#ham-1611-22277x-bod-c01-image003" />
<lb/>
<l>Location of the Dene-Yeniseian Languages</l>
<lb/>
<l>Location of the Promontory Point Moccasins</l>
</text>
</TEI>
After using TILE, your data may look like this (Notice the new zone tags where areas of interest have been drawn):
<?xml version="1.0" encoding="UTF-8"?>
<?oxygen RNGSchema="..//tei_all.rng" type="xml"?>
<?xml-stylesheet type="text/css" href="tei-11-08-08.css"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader/>
<facsimile>
<surface xml:id="ham-1611-22277x-bod-c01-image001"><desc>Image 001</desc><graphic url="promontorymoc.png"/><zone xmlns="http://www.w3.org/1999/xhtml" lry="8093.23741778644035" lrx="46468.6227394908201" uly="80" ulx="464" xml:id="1282164543676_0"></zone></surface>
<surface xml:id="ham-1611-22277x-bod-c01-image002"><desc>Image 002</desc><graphic url="rockart.png"/><zone xmlns="http://www.w3.org/1999/xhtml" lry="2737" lrx="110.2000122070312552" uly="27" ulx="110.20001220703125" xml:id="1282164644663_0"></zone><zone xmlns="http://www.w3.org/1999/xhtml" lry="2581" lrx="70.2000122070312535" uly="25" ulx="70.20001220703125" xml:id="1282164654271_0"></zone></surface>
<surface xml:id="ham-1611-22277x-bod-c01-image003"><desc>Image 003</desc><graphic url="DeneYeniseianMap.png"/><zone xmlns="http://www.w3.org/1999/xhtml" lry="8196" lrx="47.20001220703125134" uly="81" ulx="47.20001220703125" xml:id="1282164715057_3"></zone><zone xmlns="http://www.w3.org/1999/xhtml" lry="18524" lrx="109.2000122070312516" uly="185" ulx="109.20001220703125" xml:id="1282164719345_4"></zone><zone xmlns="http://www.w3.org/1999/xhtml" lry="20728" lrx="141.2000122070312543" uly="207" ulx="141.20001220703125" xml:id="1282164724041_5"></zone><zone xmlns="http://www.w3.org/1999/xhtml" lry="10379" lrx="546.200012207031257" uly="103" ulx="546.2000122070312" xml:id="1282164726809_6"></zone></surface>
</facsimile>
<text>
<pb facs="#ham-1611-22277x-bod-c01-image001"/>
<lb/>
<l>Semi-circular puckered vamp</l>
<lb/>
<l>quill work</l>
<lb facs="1282164543676_0"/>
<l>grass-lining</l>
<pb facs="#ham-1611-22277x-bod-c01-image002"/>
<lb facs="1282164644663_0"/>
<l>Funky Shoulders</l>
<lb facs="1282164654271_0"/>
<l>Spear</l>
<pb facs="#ham-1611-22277x-bod-c01-image003"/>
<lb facs="1282164726809_6"/>
<l>Location of the Dene-Yeniseian Languages</l>
<lb/>
<l>Location of the Promontory Point Moccasins</l>
</text>
</TEI>
The result is a JSON file that can be used to present your image(s) with annotations and associated areas using the TILE interface. You also have a saved XML file for archival purposes.
Using TIF or raw image data can slow down the interface considerably.
TEI/TILE compliant XML files should be used within TILE. It uses certain elements that TILE needs, and which are specified in the TILE documentation under “Making your XML TILE-Ready”