Images of Manuscripts for editions

Adding IIIF images of manuscripts to your edition

You can bind your edition to IIIF manifests so that a viewer will be visualized under the text/apparatus and translation of the text.

To do this you need to provide both the information about the location of the images explicitly and if you want the viewer to be at the page of the manuscript you want to look at, you need to tell it also this.

An example can be found in the Periplus of the Erythraean Sea. Start from encoding witnesses. You will then have to provide the additional information like in the following example, inside a <ptr>.


<witness type="external" xml:id="P" corresp="Cod. Pal. graec. 398" facs="http://digi.ub.uni-heidelberg.de/diglit/cpgraec398/0569">
      <ptr target="https://digi.ub.uni-heidelberg.de/diglit/iiif/cpgraec398/manifest.json"></ptr>
      Sammelhandschrift — Konstantinopel, letztes Viertel 9. Jh.
</witness>
             

Example 1

Note that in this example the resource is external, i.e. we do not and will not have this manuscript.

At the point in the text where the manuscript page interruption occurs, you can then add a <pb>.


<pb n="40v" corresp="#P" facs="https://digi.ub.uni-heidelberg.de/diglit/iiif/cpgraec398/canvas/0084.json"></pb>
             

Example 2

If you have more than one witness for the edition, you can add as many of these as needed in the text, connecting them with the @corresp to the correct <witness> in the file.

The content of @facs needs to be the correct canvas of that page. This is usually visible in the page of the institution publishing the manuscript or directly looking into the IIIF manifest.

There is no way for the machine to infer what the foliation corresponds to in the image set, you have to check it. Usually, the structure is quite simple, so, if you know your first-page break is 0084, the following will be 0085.

This page is referred to in the following pages

Revisions of this page

  • Pietro Maria Liuzzo on 2018-06-25: first version of guidelines from example