11 Representation of Primary Sources

This chapter defines a module intended for use in the representation of primary sources, such as manuscripts or other written materials. Section 11.1 Digital Facsimiles provides elements for handling digitally-encoded images of such materials. This module may also be useful in the preparation of critical editions, but the module defined here is distinct from that defined in chapter 12 Critical Apparatus, and may be used independently of it. Detailed metadata relating to primary sources of any kind may be recorded using the elements defined by the manuscript description module discussed in chapter 10 Manuscript Description, but again the present module may be used independently if such data is not required.

Although this chapter discusses manuscript materials more frequently than other forms of written text, most of the recommendations presented are equally applicable mutatis mutandis to the encoding of printed matter or indeed any form of written source, including monumental inscriptions. Similarly, where in the following descriptions terms such as ‘scribe’, ‘author’, ‘editor’, ‘annotator’ or ‘corrector’ are used, these may be re-interpreted in terms more appropriate to the medium being transcribed. In printed material, for example, the ‘compositor’ plays a role analogous to the ‘scribe’, while in an authorial manuscript, the author and the scribe are the same person.

TEI: Digital Facsimiles¶11.1 Digital Facsimiles

These Guidelines are mostly concerned with the preparation of digital texts in which pre-existing sources are transcribed or otherwise converted into character form, and marked up in XML. However, it is also very common practice to make a different form of ‘digital text’, which is instead composed of digital images of the original source, typically one per page, or other written surface. We call such a resource a digital facsimile. A digital facsimile may, in the simplest case, just consist of a collection of images, with some metadata to identify them and the source materials portrayed. It may sometimes contain a variety of images of the same source pages, perhaps of different resolutions, or of different kinds. Such a collection may form part of any kind of document, for example a commentary of a codicological or paleographic nature, where there is a need to align explanatory text with image data. It may also be complemented by a transcribed or encoded version of the original source, which may be linked to the page images. In this section we present elements designed to support these various possibilities and discuss the associated mechanisms provided by these Guidelines.

When this module is included in a schema, the class att.global is extended to include two new pointer attributes, facs and change:

att.global.facs facsimile 요소 내에서 이미지 또는 표면부와 관련될 수 있는 요소
facs (모사) 이미지 또는 이 요소와 일치하는 facsimile 요소의 부분을 직접 가리킨다.
att.global.change supplies the change attribute, allowing its member elements to specify one or more states or revision campaigns with which they are associated.
change points to one or more change elements documenting a state or revision campaign to which the element bearing this attribute and its children have been assigned by the encoder.

The change attribute is discussed further below in section 11.7 Identifying Changes and Revisions. The facs attribute is used to associate any element in a transcription with an image of the corresponding part of the source, by means of the usual URI pointing mechanism.

In the simple case where a digital text is composed of page images, the facs attribute on the pb element may be used to associate each image with an appropriate point in the text:

By convention, this encoding indicates that the image indicated by the facs attribute represents the whole of the text following the pb (pagebreak) element, up to the next pb element. Any convenient milestone element (see further 3.10.3 Milestone Elements) could be used in the same way; for example if the images represent individual columns, the cb element might be used. Though simple, this method has some drawbacks. It does not scale well to more complex cases where, for example, the images do not correspond exactly with transcribed pages, or where the intention is to align specific marked up elements with detailed images, or parts of images. The management of information about the images may become more difficult if references to them are scattered through many files rather than being concentrated in a single identifiable location. Nevertheless, this solution may be adequate for many straightforward ‘digital library’ applications.

The recommended approach to encoding facsimiles is instead to use the facs attribute in conjunction with the elements facsimile or sourceDoc, and the elements surface, surfaceGrp, and zone, which are also provided by this module. These elements make it possible to accommodate multiple images of each page, as well as to record the position and relative size of elements identified on any kind of written surface and to link such elements with digital facsimile images of them. Typical applications include the provision of full text search in ‘digital facsimile editions’, and ways of annotating graphics, for example so as to identify individuals appearing in group portraits and link them to data about the people represented.

The following elements are available to represent components of a digital facsimile:

facsimile 전사 또는 부호화된 텍스트 형태보다는 이미지 집합의 형태로 기록 원본의 표상을 포함한다.
sourceDoc contains a transcription or other representation of a single source document potentially forming part of a dossier génétique or collection of sources.
surface 직사각형의 좌표 공간과 그 내부에서 기록 표면부를 정의한다. 수의적으로 그 공간의 하나 이상의 그림 표상과 관심 있는 직사각형 공간을 모아놓는다.
surfaceGrp defines any kind of useful grouping of written surfaces, for example the recto and verso of a single leaf, which the encoder wishes to treat as a single unit.

zone surface 요소 내에 포함된 직사각형 영역을 정의한다.

points [att.coordinated]

identifies a two dimensional area within the bounding box specified by the other attributes by means of a series of pairs of numbers, each of which gives the x,y coordinates of a point on a line enclosing the area.

Either of the facsimile or sourceDoc elements may be used to represent a digital facsimile. Either may appear within a TEI document along with, or instead of, the text element introduced in section 4 Default Text Structure. The sourceDoc element is used when a digital facsimile contains a documentary transcription; the text element when it contains a textual transcription. When the digital facsimile contains only images, however, only facsimile elements should be used. In this section, we first discuss the simpler case, returning to the use of the sourceDoc element in section 11.2 Combining Transcription with Facsimile below. When this module is selected therefore, a legal TEI document may thus comprise any of the following:

a TEI header and a text element
a TEI header and a facsimile element
a TEI header and a sourceDoc element
a TEI header, a facsimile element, and a text element
a TEI header, one or more sourceDoc or facsimile elements, and a text element

Like the text element, a facsimile element may also contain an optional front or back element, used in the same way as described in sections 4.5 Front Matter and 4.7 Back Matter.

In the simplest case, a facsimile just contains a series of graphic elements, each of which identifies an image file:

If desired, the binaryObject element described in 3.9 Graphics and Other Non-textual Components (or any other element from the model.graphicLike class) can be used instead of a graphic.

In this simple case, the four page images are understood to represent the complete facsimile, and are to be read in the sequence given. Suppose, however, that the second page of this particular work is available both as an ordinary photograph and as an infra-red image, or in two different resolutions. The surface element may be used to group the two image files, since these correspond with the same area of the work:

The surface element provides a way of indicating that the two images of page2 represent the same surface within the source material. A surface might be one side of a piece of paper or parchment, an opening in a codex treated as a single surface by the writer, a face of a monument, a billboard, a membrane of a scroll, or indeed any two-dimensional surface, of any size.

The surfaceGrp element may be used to indicate that two (or more) surfaces are associated in some way, for example because they represent the recto and verso of the same leaf, as in this example:

The surfaceGrp element may also be useful as a means of identifying other groups of written surfaces, such as adjacent faces of a monument, or gatherings of leaves.

Simply grouping related graphics is not however the main purpose of the surface element: rather it is to help identify the location and size of the various two-dimensional spaces constituting the digital facsimile. Note that the actual dimensions of the object represented are not provided by the surface element ; rather, the surface element defines an abstract coordinate space which may be used to address parts of the image. Four attributes supplied by the att.coordinated class are used to define this space.

att.coordinated 이차원 좌표 체계 내에서 위치될 수 있는 요소

ulx	직사각형 공간의 좌측 상단에 대한 x 좌표 값을 제시한다.
uly	직사각형 공간의 좌측 상단에 대한 y 좌표 값을 제시한다.
lrx	직사각형 공간의 오른쪽 하단에 대한 x 좌표 값을 제시한다.
lry	직사각형 공간의 오른쪽 하단에 대한 y 좌표 값을 제시한다.

By default, the same coordinate space is used for a surface and for all of its child elements.⁴¹ It may be most convenient to derive a coordinate space from a digital image of the surface in question such that each pixel in the image corresponds with a whole number of units (typically 1) in the coordinate space. In other cases it may be more convenient to use units such as millimetres. Neither practice implies any specific mapping between the coordinate system used and the actual dimensions of the physical object represented.

A surface element can contain one or more zone elements, each of which represents a region or bounding box defined in terms of the same coordinate space as that of its parent surface element. A zone may be rectangular or non-rectangular: a rectangular zone is defined by a sequence of four coordinates in the same way as a surface; a non-rectangular zone is defined using the attribute points, which provides a sequence of coordinates, each of which specifies a point on the perimeter of the zone.⁴²

A zone may be used to define any region of interest, such as a detail or illustration, or some part of the surface which is to be aligned with a particular text element, or otherwise distinguished from the rest of the surface. A surface establishes a coordinate system which may be used to address parts or the whole of some digital representation of a written surface. A zone, by contrast, defines any arbitrary area of interest relative to that surface, using the same coordinate system. It might be bigger or smaller than its parent surface, or might overlap its boundaries. The only constraint is that it must be defined using the same coordinate system.

When an image of some kind is supplied within either a zone or a surface, the implication is that the image represents the whole of the zone or surface concerned. In the simple case therefore, we might imagine a surface defining a page, within which there is a graphic representing the whole of that page, and a number of zones defining parts of the page, each with its own graphic, each representing a part of the page. If however one of those graphics actually represents an area larger than the page (for example to include a binding or the surface of a desk on which the page rests), then it will be enclosed by a zone with coordinates larger than those of the parent surface.

For example, consider the following figure:

그림 11.1. Badische Landesbibliothek, Manuscript Durlach 1, Fols. 95v-96r

This is an image of a two page spread from a manuscript in the Badische Landesbibliothek, Karlsruhe. We have no information as to the dimensions of the original object, but the low resolution image displayed here contains 500 pixels horizontally and 321 pixels vertically. For convenience, we might map each pixel to one cell of the coordinate space.⁴³

We therefore define a surface element corresponding with the area of the image which represents the whole of the two page spread and embed the graphic within it:

If desired, the binaryObject element described in 3.9 Graphics and Other Non-textual Components (or any other element from the model.graphicLike class) may be used instead of a graphic element.

Since the image in this example is of a two page opening, we will probably wish to define at least two nested zones, one for each page:

As this example shows, in addition to acting as a container for graphic elements, zone elements may be used to identify parts of a surface for analytical purposes.

The relationship between zone and surface can be quite complex: for example, it may be appropriate to treat the whole of a two page spread as a single written surface, perhaps because particular written zones span both pages. A zone may contain a nested surface, if for example a page has an additional scrap of paper attached to it. A zone may be of any shape, not simply rectangular. Discussion of these and other cases are provided in section 11.4 Advanced Uses of surface and zone below.

In the following extended example, we discuss a hypothetical digital edition of an early 16th century French work, Charles de Bovelles' Géometrie Pratique.⁴⁴ In this edition, each page has been digitized as a separate file: for example, recto page 49 is stored in a file called Bovelles-49r.png. In the facsimile element used to contain the whole set of pages, we define a surface element for this page, which we situate within a coordinate scale running from 0 to 200 in the x (horizontal) axis, and 0 to 300 in the y (vertical) axis. The surface element contains a graphic element which represents the whole of this surface:

We can now identify distinct zones within the page image using the coordinate scale defined for the surface. In the following figure 그림 11.2, Detail of p 49r from Bovelles Géometrie Pratique we show the upper part of the page, with boxes indicating four such zones. Each of these will be represented by a zone element, given within the surface element already defined, and specified in terms of the same coordinate system. Some zones of interest are indicated by red lines in the following image.

그림 11.2. Detail of p 49r from Bovelles Géometrie Pratique

The following encoding defines each of the four zones identified in the figure above.

Note that the location of each zone is defined independently but using the same coordinate system.

A non rectangular-zone, for example that containing the word cloche. at bottom left of the page, could also be defined, using the points attribute:

In this example a single graphic element has been associated directly with the surface of the page rather than nesting it within a zone. However, it is also possible to include multiple zone elements which contain a graphic element, if for example a detailed image is available. Since all zone elements use the same coordinate system (that defined by their parent surface), there is no need to demonstrate enclosure of one zone within another by means of nesting. To continue the current example, supposing that we have an additional image called Bovelles49r-detail.png containing an additional image of the figure in the third zone above, we might encode that zone as follows:

TEI: Combining Transcription with Facsimile¶11.2 Combining Transcription with Facsimile

A digitized source document may contain nothing more than page images and a small amount of metadata. It may also contain an encoded transcription of the pages represented, which may either be ‘embedded’ within a sourceDoc element, or supplied in parallel with a facsimile as defined above.

If the transcription is regarded as a text in its own right, organized and structured independently of its physical realization in the document or documents represented by the facsimile, then the recommended practice is to use the text element to contain such a structured representation, and to present it in parallel. The text element is a sibling of the facsimile and sourceDoc elements. This approach is illustrated in section 11.2.1 Parallel Transcription below. Alternatively, if the transcription is intended not to prioritize representation of the final text so much as the process by which the document came to take its present form, or the physical disposition of its component parts, it may be preferable to present it as an embedding transcription, as further described in section 11.2.2 Embedded Transcription below.

TEI: Parallel Transcription¶11.2.1 Parallel Transcription

Suppose now that we wish to align a transcription of the page discussed in the preceding section with particular zones. We begin by giving each relevant part of the facsimile an identifier:

The alignment between transcription and image is made, as usual, by means of the facs attribute:

<pb facs="#B49r"/>
<fw>De Geometrie 49</fw>
<head facs="#B49rHead"> DU SON ET ACCORD DES CLOCHES ET <lb/> des alleures des
chevaulx, chariotz & charges, des fontaines:& <lb/> encyclie du monde,
& de la dimension du corps humain.<lb/> Chapitre septiesme</head>
<div n="1">
<p>Le son & accord des cloches pendans en ung mesme <lb/> axe, est faict en
   contraires parties.</p>
<p rend="it" facs="#B49rPara2">LEs cloches ont quasi fi<lb/>gures de rondes
   pyra<lb/>mides imperfaictes & <lb/> irregulieres: & leur accord se
<lb/> fait par reigle geometrique. Com<lb/>me si les deux cloches C & D
<lb/> sont <w facs="#B49rW457">pendans</w> à ung mesme axe <lb/> ou essieu A B:
   je dis que leur ac<lb/>cord se fera en co<ex>n</ex>traires parties<lb/>
   co<ex>m</ex>me voyez icy figuré. Car qua<ex>n</ex>d <lb/> lune sera en
   hault, laultre declinera embas. Aultrement si elles decli<lb/>nent toutes deux
   ensembles en une mesme partie, elles seront discord, <lb/> & sera leur
   sonnerie mal plaisante à oyr.<figure facs="#B49rFig1">
   <graphic url="Bovelles49r-detail.png"/>
  </figure>
</p>
</div>

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 at least the start of the transcribed text found within the surface or zone concerned. Thus, another way of linking this page with its transcription would be simply

<facsimile>
<surface start="#PB49R">
  <graphic url="Bovelles-49r.png"/>
</surface>
</facsimile>
<text>
<body>
  <div>

   <pb xml:id="PB49R"/>
   <fw>De Geometrie 49</fw>

  </div>
</body>
</text>

TEI: Embedded Transcription¶11.2.2 Embedded Transcription

An embedded transcription is one in which words and other written traces are encoded as subcomponents of elements representing the physical surfaces carrying them rather than independently of them.

The following elements are available for this purpose:

sourceDoc contains a transcription or other representation of a single source document potentially forming part of a dossier génétique or collection of sources.
surface 직사각형의 좌표 공간과 그 내부에서 기록 표면부를 정의한다. 수의적으로 그 공간의 하나 이상의 그림 표상과 관심 있는 직사각형 공간을 모아놓는다.
zone surface 요소 내에 포함된 직사각형 영역을 정의한다.
line contains the transcription of a topographic line in the source document
seg (임의의 분절) (다른 분절 요소를 포함하여) 텍스트의 임의의 구-층위 단위를 포함한다.

The elements surface, surfaceGrp, and zone were introduced above in section 11.1 Digital Facsimiles. When supplied within a sourceDoc element, these elements may contain transcriptions of the written content of a source in addition to or as an alternative to digital images of them. Such transcription may be placed directly within the zone element, or within one or more line elements, for cases where the writing is linear, in the sense that it is composed of discrete tokens organized physically into groups, typically organized in a sequence corresponding with the way they are intended to be read. Depending on the directionality of the writing system used, this might be any combination of top-down and left to right, or vice versa. The element line may be used to hold a complete group of such tokens. Where, however, the lineation is not considered significant, any group of tokens may be indicated using the zone element. The seg element described in section 16.3 Blocks, Segments, and Anchors may also be used to indicate smaller sequences of tokens within zone, or line as appropriate.

Returning to the preceding example, we might transcribe the content of the zone to which we gave the identifier B49rPara2 within a sourceDoc element as follows:

<sourceDoc>
<surface ulx="0" uly="0" lrx="200" lry="300">
  <zone ulx="0" uly="0" lrx="200" lry="300">
   <graphic url="Bovelles-49r.png"/>
  </zone>

  <zone ulx="28" uly="75" lrx="175" lry="178">
   <line>LEs cloches ont quasi
       fi</line>
   <line>gures de rondes pyra</line>
   <line>mides imperfaictes &
   </line>
   <line> irregulieres: & leur accord se</line>
   <line> fait par reigle geometrique. Com</line>
   <line>me si les deux cloches C
       & D </line>
   <line> sont <zone ulx="45" uly="125" lrx="60"
     lry="130">pendans</zone> à ung mesme axe</line>
   <line> ou essieu A B: je dis que
       leur ac</line>
   <line>cord se fera en cõtraires parties</line>
   <line> cõme
       voyez icy figuré. Car quãd </line>
   <line> lune sera en hault, laultre
       declinera embas. Aultrement si elles declinent toutes deux ensembles en une
       mesme partie, elles seront discord,</line>
   <line> & sera leur sonnerie
       mal plaisante à oyr.</line>
  </zone>
  <zone ulx="105" uly="76" lrx="175"
   lry="160">
   <graphic url="Bovelles49r-detail.png"/>
  </zone>
</surface>
</sourceDoc>

As mentioned above, some or all of the written surfaces being transcribed may be composed of physically distinct scraps. In the following example, taken from the Walt Whitman Archive, two pieces of newsprint have been glued to a piece of blue paper on which a poem is being drafted:

Single leaf of notes possibly related to the poem eventually titled
Sleepers. From the Walt Whitman Archive (Duke 258). — 그림 11.3. Single leaf of notes possibly related to the poem eventually titled Sleepers. From the Walt Whitman Archive (Duke 258).

The two pieces of newsprint might simply be regarded as special kinds of zone, but they are also new surfaces, since they might contain additional written zones themselves (such as the numbers in this case).

Using these elements, the Whitman draft above might be encoded as follows:

<surface>
<zone>
  <line>Poem</line>
  <line>As in Visions of — at</line>
  <line>night —</line>
  <line>All sorts of fancies running through</line>
  <line>the head</line>
</zone>
<zone>
  <surface type="newsprint"
   attachment="glue" flipping="false">
   <zone>Spring has just set in here, and the weather[...] a steamer </zone>
   <metamark function="sequence">2</metamark>
  </surface>
</zone>
<zone>
  <surface type="newsprint"
   attachment="glue" flipping="false">
   <zone>"The shores on either side of the Sound are... The In- </zone>
   <metamark function="sequence">3</metamark>
  </surface>
</zone>
</surface>

cert	(확실성) 간섭 또는 해석과 연관된 확실성의 정도를 나타낸다.
resp	(책임 당사자) 편집자 또는 전사자와 같이 또는 해석에 대한 책임이 있는 대리인을 나타낸다.

type	다양한 분류 스키마 또는 유형을 사용해서 요소의 특성을 기술한다.
subtype	필요하다면 요소의 하위범주를 제시한다.

seq	(연쇄) 이 속성을 포함하는 부호화된 자질이 발생했다고 가정되는 순서와 관련된 번호를 할당한다.
status	간섭의 효과를 나타낸다. 예를 들어, 삭제의 경우 너무 많은 또는 너무 적은 텍스트를 포함한 지우기, 또는 추가의 경우, 이미 존재하는 텍스트 일부의 중복 삽입 등. 샘플 값은 다음을 포함한다 Sample values include: 1] duplicate; 2] duplicate-partial; 3] excessStart; 4] excessEnd; 5] shortStart; 6] shortEnd; 7] partial; 8] unremarkable
hand [att.written]	간섭을 만든 당사자의 필적을 나타낸다.

reason	누락의 이유를 제시한다. 그 값의 예들은 다음과 같다: sampling, illegible, inaudible, irrelevant, cancelled, cancelled and illegible.
hand	어떤 특정 수작업자가 의도적으로 전사본에서 생략된 텍스트의 경우, 그 생략의 장본인을 표시한다.
agent	훼손으로 인해 누락된 텍스트의 경우, 확인이 가능하다면 그 훼손 원인을 분류하여 기술한다. 샘플 값은 다음을 포함한다 Sample values include: 1] rubbing; 2] mildew; 3] smoke

scribe	이 필적에 대한 책임이 있다고 간주되는 필기사에 대한 표준명 또는 다른 확인소를 제시한다.
script	secretary, copperplate, Chancery, Italian 등과 같이 이 필적으로 사용된 특별한 필사본 또는 글쓰기 스타일의 특성을 기술한다.
scribeRef	points to a full description of the scribe concerned, typically supplied by a person element elsewhere in the description.
scriptRef	points to a full description of the script or writing style used by this hand, typically supplied by a scriptNote element elsewhere in the description.
medium	brown와 같이 잉크의 색 또는 유형, 또는 pencil와 같이 글쓰기 방식 기술한다.
scope	이 필적이 원고에서 사용된 범위를 명시한다.

extent	indicates the size of the object concerned using a project-specific vocabulary combining quantity and units in a single string of words.
unit	측정 단위의 이름을 기술한다. 제안값은 다음을 포함한다: 1] cm(centimetres) ; 2] mm(millimetres) ; 3] in(inches) ; 4] lines; 5] chars(characters)
quantity	명시된 단위의 길이를 명시한다.

min	where the measurement summarizes more than one observation or a range, supplies the minimum value observed.
max	where the measurement summarizes more than one observation or a range, supplies the maximum value observed.
atLeast	gives a minimum estimated value for the approximate measurement.
atMost	gives a maximum estimated value for the approximate measurement.

function	describes the function (for example status, insertion, deletion, transposition) of the metamark.
target	identifies one or more elements to which the metamark applies.

hand [att.written]	간섭을 만든 당사자의 필적을 나타낸다.
agent	식별될 수 있다면 그 손상의 원인을 분류한다. 샘플 값은 다음을 포함한다 Sample values include: 1] rubbing; 2] mildew; 3] smoke
degree	다양한 척도에 따라 손상 정도를 나타낸다. degree 속성과 함께 damage 태그는 텍스트가 확인 가능한 곳에서만 사용되어야 한다; 다른 원본에서 가져온 텍스트는 supplied를 부착한다.
group	동일 물리적 현상의 부분을 형성하는 것으로 간주되는 손상에 대해 각각 임의적 숫자를 할당한다.

P5: 전자 텍스트 부호화 및 교환에 대한 지침