Corresponding page images

This system holds for every kind of document, both printed and manuscript material, even if the manuscript is only one page long.

There are two steps to linking a document to its corresponding image:

  1. The name and location of each image must be declared in the header right before the <tei2> tag. This can be keyed in on a plain-text editor such as NoteTab or in Epic, under the "Entities" menu go to "graphic." A sample entity declaration:

    <!ENTITY loc.00001.001 SYSTEM "loc.00001.001.jpg" NDATA jpeg>
    <!ENTITY loc.00001.002 SYSTEM "loc.00001.002.jpg" NDATA jpeg>
    <!ENTITY loc.00001.003 SYSTEM "loc.00001.003.jpg" NDATA jpeg>
    etc.
  2. PLEASE NOTE:
    • entity names should NOT include the file extension
    • be sure the file name which follows SYSTEM includes the dot before the file extension
    • be sure to use consistent language when giving file extensions -- we've chosen to always use ".jpg"
    • the last portion of the declaration, "NDATA jpeg" should always be noted in that way, and this does not contradict the rule above.

  3. Second, use the <pb> element BEFORE the content of each page to refer to the appropriate file:
    Using the page break element, the <corresp> attribute links to the corresponding image:

    <text><body>
    <pb corresp="loc.00001.001" id="leaf01" type="recto">
    <lg1><l>etc.

    PLEASE NOTE:

    • do not include the file extension here
    • the "type" attribute is now required on the <pb> element. Choose between "recto" and "verso."
    • For pages which have both a recto and a verso, the content of the id attribute must be changed, since id's must be unique. For a leaf one recto, use id="leaf01r"; for leaf one verso, use id="leaf01v"
    • id attribute is necessary even on one-page documents, as that is where the stylesheet will look for the page number.
    • for printed works, if you want the page numbers to display, also include the n= attribute for each <pb>. So: <pb corresp="ppp.00001.001" id="leaf01" type="recto" n="1">