1. Working with facsimiles

Increasingly people want to do not just 'text' editions but text editions with facing
page (or otherwise linked) facsimile images. Indeed, some people want to just have images
and create and electronic facsimile (perhaps with a view to later eventual transcription).
The <facsimile> element (a sibling of <teiHeader> and <text>) is
provided to accommodate this desire.

1.1. Digital Facsimiles

<facsimile> contains a representation of some written source in the form of a
set of images rather than as transcribed or encoded text

<surface> defines a written surface in terms of a rectangular coordinate space

start points to an element which encodes the starting position of
the text

<zone> defines a rectangular area contained within a <surface>
element

Global facs (facsimile) points directly to an image, or to a part of a
facsimile element which corresponds with this element.

1.2. Simplest case: 1:1 mapping with facs

If a digital text contains one image per page or column (or similar unit), and no more
complex mapping between text and image is envisaged, then the facs attribute
may be used to point directly to a graphic resource.

1.3. Using facs in conjunction with <facsimile>, <surface>, and
<zone>

Using these attributes and elements together enables an editor to

associate multiple images with each page

record arbitrary planar coordinates of textual elements on any kind of surface
and link such elements to digital facsimile images of them

1.4.
<facsimile>

The facsimile element is used to represent a digital facsimile. It appears within a TEI
document along with, or instead of, the (which contains textual transcription). When the
“transcr” module is selected, a valid TEI document may thus comprise any of the
following:

1.7. dimensions

The actual dimensions of the object represented are not documented by the surface
element; instead, the surface is located within an abstract coordinate space, which is
defined by the following attributes, supplied by the att.coordinated class:

ulx gives the x coordinate value for the upper left corner of a
rectangular space

uly gives the y coordinate value for the upper left corner of a
rectangular space.

lrx gives the x coordinate value for the lower right corner of a
rectangular space.

lry gives the y coordinate value for the lower right corner of a
rectangular space.

1.8. Example drawing rectangles

1.9. <surface> Example

1.10. <zone> in <surface>

To describe the whole image, we will also need to define a zone of interest which
represents an area inside this surface. This zone of interest can be defined by a
<zone> element, within which we can place the <graphic>:

1.16. Linking transcription and facsimile: text

1.17. Pointing from <facsimile> to transcription with start
attribute

It is also possible to point in the other direction, from a <surface> or
<zone> to the corresponding text. This is the function of the start
attribute, which supplies the identifier of the element containing the transcribed text
found within the <surface> or <zone> concerned.