1. Text image linking

2. TEI document (i.e. text) model
element TEI { …
( teiHeader, ( ( model.resourceLike+, text? ) | text ) ) }
Members of model.resourceLike are: facsimile fsdDecl sourceDoc

3. Facsimile → Images <facsimile> <graphic url="page1.png"/>
[A series of images, referenced by <graphic>, e.g. pages of a book.]
Alternative:
<media mimeType="image/png" url="page1.png"/>
Remark: Usually the order of elements is meaningful.
In order to reference from the transcription to the images one needs to
The XML can be transformed in any possible way during processing, e.g. sorted.

4. Facsimile → Identify images
<graphic xml:id="page_1" url="page1.png"/>
<graphic xml:id="page_2" url="page2.png"/>
<graphic xml:id="page_3" url="page3.png"/>
<graphic xml:id="page_4" url="page4.png"/>
</facsimile>
[A series of referenceable images, identified

5. Reference identified images
<text>
<pb facs="page1.png"/>
<!-- text contained on page 1 is encoded here -->
<pb facs="page2.png"/>
<!-- text contained on page 2 is encoded here -->
</text>
Global (if module transcr is loaded)
Discussion whether milestone elements mark the beginning or the end of a span of text is settled → put them at the beginning!
Find the mistake!

6. Reference identified images
<text>
<pb facs="page1.png"/>
<!-- text contained on page 1 is encoded here -->
<pb facs="page2.png"/>
<!-- text contained on page 2 is encoded here -->
</text>
These are the names of the images, not the values

7. Facsimile → Group images
<graphic url="page1.png"/>
<surface>
<graphic url="page2-highRes.png"/>
<graphic url="page2-lowRes.png"/>
</surface>
<graphic url="page3.png"/>
<graphic url="page4.png"/>
</facsimile>
[<surface> might be used to group images that show the same surface.]

8. Facsimile → Group groups of images
<surfaceGrp n="leaf1">
<surface>
<graphic url="page1.png"/>
</surface>
<graphic url="page2-highRes.png"/>
<graphic url="page2-lowRes.png"/>
</surfaceGrp>
</facsimile>
[<surfaceGrp> might be used to group surfaces i.e. to represent leafs.]
This TEI markup might be used to document the whole file structure of a project, e.g. images in different resolutions.
This is still the file level!
There are other formats out there to achieve the same and maybe better, e.g. METS

9. TEI vs. other formats
This TEI markup might be used to document the whole file structure of a project, e.g. images in different resolutions.
This is still the file level!
There are other formats out there to achieve the same and maybe better, e.g. METS (Metadata Encoding and Transmission Standard)
HAB Digital library uses METS
e.g.

10. Ambiguous TEI
The examples using <facsimile> with <surface> are ambiguous:
On one hand
<facsimile> contains a representation of some written source in the form of a set of images rather than as transcribed or encoded text.
On the other had
<surface> defines a written surface as a two-dimensional coordinate space, optionally grouping one or more graphic representations of that space, zones of interest within that space, and transcriptions of the writing within them.

11. surface
Contained by transcr: facsimile sourceDoc surface surfaceGrp zone
@attachment describes the method by which this surface is or was
connected to the main surface
Sample values include: 1] glued; 2] pinned; 3] sewn
@flipping indicates whether the surface is attached and folded
in such a way as to provide two writing surfaces
… )

12. zone defines any two-dimensional area within a surface element.
@rotate indicates the amount by which this zone has been
rotated clockwise […]. The orientation is expressed in
arc degrees.
… )

13. Beware
The coordinates stored in @lry, …) are taken from an image with a certain resolution!
If you use multiple images with different resolutions in your webpage you will have to calculate the actual coordinates of a zone in the image shown.

14. Oxygen TEI-Facsimile-Plugin
How to install it
Unzip builds/addon/image-markup-plugin SNAPSHOT-plugin.zip inside {OxygenInstallDir}/plugins/
After installing it, you should see an Image Markup Sample button on the toolbar. Click it to launch a sample file and to initialize the Image-Markup view with an image.
If you right click on a rectangle in image view, you can either delete it (and will reflect in the editor) or copy it.
You can use the mouse to draw a new rectangle over the image. Then right click and copy its coordinates to paste them in the editor.

15. Exercise
Load an image
Open a file and create a <facsimile>/<surface>
Mark some zones and store them in the surface.

16. Alternatives
TILE Text Image Linking Environment (
TextGrid