Images, figures and facsimile

2017-12-12

Many EpiDoc projects will need to refer users to images of the text-bearing objects treated by the projects, and to other relevant imagery that provides context or comparison. Such images may be photographs or drawings ("copies") of the objects themselves or of intermediary derivatives like squeezes, rubbings, and ink-transfers (estampages), as well as other kinds of maps, plans, and illustrations. The TEI provides a variety of mechanisms for making reference to such visual materials, whether published alongside the textual material produced by the project or published by third parties online or in print.

Encoding Digital Imagery

When an EpiDoc project publishes digital images of an inscribed object alongside textual material, the <facsimile> element should be used to list, link to, and describe the images, and to connect them to the textual and analytic material marked up elsewhere in the XML. The encoding approach outlined in the initial sections of the TEI Guidelines, chapter 11 "Representation of Primary Sources" should be followed by EpiDoc projects where appropriate. This portion of the TEI Guidelines also describes the use of the <sourceDoc> element, which should be used instead of <facsimile> when a project has comprehensive photographic documentation for a text-bearing object, and when the goals of the project and the character of the text call for a digital facsimile that contains a documentary transcription tied to the visible layout in the photographs.

Using the <facsimile> element

The following examples, adapted from the Inscriptions of Aphrodisias and from the Corpus of the Inscriptions of Campā, illustrate the application of the <facsimile> element (and some of its optional subordinate elements) in an EpiDoc context. Additional examples drawn from the TEI Guidelines may also provide helpful encoding patterns.

<facsimile>
 <surface n="i">
  <desc>Face of inscribed base</desc>
  <graphic url="http://insaph.kcl.ac.uk/images/photo/full/72_L_27A.jpg">
   <desc>Photograph (1972)</desc>
  </graphic>
  <graphic url="http://insaph.kcl.ac.uk/images/photo/full/NY_pr_046.jpg">
   <desc>Squeeze</desc>
  </graphic>
 </surface>
 <surface>
  <desc>Top of base</desc>
  <graphic url="http://insaph.kcl.ac.uk/images/photo/full/NY_94_55_03.jpg">
   <desc>Photograph (1994)</desc>
  </graphic>
 </surface>
 <surface>
  <desc>Inscription on head of statue</desc>
  <graphic url="http://insaph.kcl.ac.uk/images/photo/full/smith-ala254.jpg">
   <desc>Drawing (2001)</desc>
  </graphic>
 </surface>
</facsimile>
<facsimile>
 <graphic xml:id="fac1"
  url="../images/inscriptions/C0215_1_AG_2011.jpg">

  <desc>Photograph of the front of the sculptural stela whose back bears
     inscription <ptr target="#inv-general"/>. Taken in the exhibition room
     at the Trà Kiệu church by Arlo Griffiths on <date when="20111123"/>.</desc>
 </graphic>
 <graphic xml:id="fac2"
  url="../images/inscriptions/C0215_2_AG_2011.jpg">

  <desc>Photograph of inscription <ptr target="#inv-general"/>. Taken in the
     exhibition room at the Trà Kiệu church by Arlo Griffiths on <date when="20111123"/>.</desc>
 </graphic>
 <graphic xml:id="fac3"
  url="../images/inscriptions/EFEOB-est.n2129.jpg">

  <desc>Photograph of EFEO estampage n. 2129.</desc>
 </graphic>
</facsimile>

Using the <zone> element

Within <facsimile>, EpiDoc follows default TEI in allowing <surface> to contain the <zone> element, which defines any two-dimensional area within <surface>. This permits the editor to identify a section of the support and to associate it with an area within the facsimile in which it is represented. A zone may be of any shape: a rectangular zone can be defined using ulx, uly, lrx, and lry, while a polygonal zone can be defined using points. These same attributes can also be used on the <surface> element itself. More complex examples can be found in the TEI Guidelines.

<facsimile>
 <surface>
  <desc>Face of the inscribed altar.</desc>
  <graphic url="../images/a0001.jpg">
   <desc>Photograph (2014)</desc>
  </graphic>
  <zone ulx="240uly="25lrx="400"
   lry="280">
Column B of the inscribed
     text.</zone>
 </surface>
</facsimile>

Citing Externally Published Images of the Text-bearing Object

When signalling the availability of images published externally to the EpiDoc project (whether available on-line or only in print), editors may prefer to treat references to these images as bibliographic citations. The following example adapts conventions used by the Digital Corpus of Literary Papyrology project for this purpose, subtyping the standard EpiDoc div with type = "bibliography".

<div type="bibliography"
 subtype="illustrations">

 <listBibl>
  <bibl type="printed">G. Cavallo - H.Maehler, Greek Bookhands, pl.10b</bibl>
  <bibl type="online">
   <title level="m">Berliner Papyrusdatenbank</title>: "<title level="a">P.
       11629 a+b: Fragmente aus Kallimachos, Aitia I und III.</title>," <ptr target="http://berlpap.smb.museum/03174/"/>
  </bibl>
 </listBibl>
</div>

See also:

Other pages describing <div>:

Other pages describing <desc>:

Other pages describing <bibl>:

Other pages describing <date>:

Responsibility for this section

  1. Gabriel Bodard, author
  2. Tom Elliott, author
  3. Arlo Griffiths, author
  4. Charlotte Tupman, author

EpiDoc version: 9.0

Date: 2017-12-12