How to annotate and present areas of interest in an image

Introduction 

This is a recipe for annotating and presenting an image with TEI/TILE-compliant text.

Ingredients 

image file (see X for converting TIFF to JPG)

associated TEI/TILE-compliant text about the image

Steps 

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>

Discussion 

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”

Next steps / further information 

TILE Documentation Page: http://mith.umd.edu/tile/documentation/

Using manuscript data in TILE

Making your own customized JSON file, using the structure written out in the TILE Documentation

Add text of annotations in TILE