StrawManFacsimileMarkup
Jump to navigation
Jump to search
v v3
<TEI>
<teiHeader>
<taxonomy id="facsimile-types">
<!-- seems to me there are a variety of possible facsimile types ('uses'), -->
<!-- and that projects might come up with new ones, or specialize existing ones -->
<!-- as in the "very-small-thumbnail" below, which would mean providing a basic -->
<!-- taxonomy which would be shared and part of the guidelines, while allowing -->
<!-- extension -->
<!-- how to use with tei:ref/@type? or replace tei:ref below with something else? -->
<bibl>
<ref target="{pointer to a standard taxonomy of basic facsimile roles/relationships}"/>
</bibl>
<category xml:id="text">
<catDesc>Textual form</catDesc>
</category>
<category xml:id="thumbnail">
<catDesc>Thumbnail image</catDesc>
<category xml:id="very-small-thumbnail">
<catDesc>Extra small thumbnail</catDesc>
</category>
</category>
<category xml:id="access">
<catDesc>Large image</catDesc>
</category>
<category xml:id="annotation">
<catDesc>Large annotated image</catDesc>
</category>
</taxonomy>
...
<!-- list of pages -->
<pg xml:id="pg1" width="100mm" height="120mm">
<!-- list of graphics which are images of this page -->
<!-- @graphicType allows classification of graphics by resolution, equipment, or suitability for purpose -->
<!-- xml:id, url, and mimeType are all existing attributes of tei:graphic -->
<!-- The other attributes would give the position of the corner of the graphic (in the coordinate space of the
parent pg element). NB the thumbnail and access images below have different scales, but they both cover the
same area of the page, namely the region stretching from a point 10mm in from the left margin of the page,
and 10mm down from the top of the page, down 8cm and across 10cm. If the image files were cropped to exactly
match the size of the page, they would have leftX and leftY equal to 0. If the scans included white space
around the edge of the physical pages, then the values would be negative. -->
<graphic
facsimileType="#thumbnail"
xml:id="thumb-p1"
url="thumb-p1.jpg"
mimeType="image/jpeg"
scale="4.0"
leftX="10mm"
topY="10mm"
width="80mm"
height="100mm"/>
<graphic
graphicType="#access"
xml:id="access-p1"
url="access-p1.jpg"
mimeType="image/jpeg"
scale="1.0"
leftX="10mm"
topY="10mm"
width="80mm"
height="100mm"/>
<!-- an SVG customisation should allow svg:svg here -->
</pg>
<!-- more pages ... -->
<pg xml:id="pg2" width="100mm" height="120mm">
<graphic facsimileType="#thumbnail" xml:id="thumb-p2" url="thumb-p2.jpg" mimeType="image/jpeg"/>
<graphic facsimileType="#access" xml:id="access-p2" url="access-p2.jpg" mimeType="image/jpeg"/>
</pg>
...
</teiHeader>
<body>
...
<pb xml:id="pb1" decls="#pg1"/>
...
<!-- the paragraph below occupies the rectangle whose corners are (20, 200) and (120, 230) -->
<p leftX="20" topY="200" width="100" height="30">Blah blah blah blah blah.</p>
...
<pb xml:id="pb2" decls="#pg2"/>
...
<pb xml:id="pb3" decls="#pg3"/>
...
<pb xml:id="pb4" decls="#pg4"/>
...
<pb xml:id="pb5" decls="#pg5"/>
...
</body>
</TEI>
v2
<TEI>
<teiHeader>
<taxonomy id="facsimile-types">
<!-- seems to me there are a variety of possible facsimile types ('uses'), -->
<!-- and that projects might come up with new ones, or specialize existing ones -->
<!-- as in the "very-small-thumbnail" below, which would mean providing a basic -->
<!-- taxonomy which would be shared and part of the guidelines, while allowing -->
<!-- extension -->
<!-- how to use with tei:ref/@type? or replace tei:ref below with something else? -->
<bibl>
<ref target="{pointer to a standard taxonomy of basic facsimile roles/relationships}"/>
</bibl>
<category xml:id="text">
<catDesc>Textual form</catDesc>
</category>
<category xml:id="thumbnail">
<catDesc>Thumbnail image</catDesc>
<category xml:id="very-small-thumbnail">
<catDesc>Extra small thumbnail</catDesc>
</category>
</category>
<category xml:id="access">
<catDesc>Large image</catDesc>
</category>
<category xml:id="annotation">
<catDesc>Large annotated image</catDesc>
</category>
</taxonomy>
...
<!-- list of pages -->
<!-- each page corresponds to a span of text using @from and @to (cf. span element), and has physical dimensions -->
<pg xml:id="pg1" from="#pb1" to="#pb2" width="100mm" height="120mm">
<!-- list of graphics which are images of this page -->
<!-- @graphicType allows classification of graphics by resolution, equipment, or suitability for purpose -->
<!-- xml:id, url, and mimeType are all existing attributes of tei:graphic -->
<!-- The other attributes would give the position of the corner of the graphic (in the coordinate space of the
parent pg element). NB the thumbnail and access images below have different scales, but they both cover the
same area of the page, namely the region stretching from a point 10mm in from the left margin of the page,
and 10mm down from the top of the page, down 8cm and across 10cm. If the image files were cropped to exactly
match the size of the page, they would have leftX and leftY equal to 0. If the scans included white space
around the edge of the physical pages, then the values would be negative. -->
<graphic
facsimileType="#thumbnail"
xml:id="thumb-p1"
url="thumb-p1.jpg"
mimeType="image/jpeg"
scale="4.0"
leftX="10mm"
topY="10mm"
width="80mm"
height="100mm"/>
<graphic
graphicType="#access"
xml:id="access-p1"
url="access-p1.jpg"
mimeType="image/jpeg"
scale="1.0"
leftX="10mm"
topY="10mm"
width="80mm"
height="100mm"/>
<!-- an SVG customisation should allow svg:svg here -->
</pg>
<!-- more pages ... -->
<pg xml:id="pg2" from="#pb2" to="#pb3" width="100mm" height="120mm">
<graphic facsimileType="#thumbnail" xml:id="thumb-p2" url="thumb-p2.jpg" mimeType="image/jpeg"/>
<graphic facsimileType="#access" xml:id="access-p2" url="access-p2.jpg" mimeType="image/jpeg"/>
</pg>
...
</teiHeader>
<body>
...
<pb xml:id="pb1"/>
...
<!-- the paragraph below occupies the rectangle whose corners are (20, 200) and (120, 230) -->
<p leftX="20" topY="200" width="100" height="30">Blah blah blah blah blah.</p>
...
<pb xml:id="pb2"/>
...
<pb xml:id="pb3"/>
...
<pb xml:id="pb4"/>
...
<pb xml:id="pb5"/>
...
</body>
</TEI>
v1
<teiHeader>
<taxonomy id="facsimile-types">
<!-- seems to me there are a variety of possible facsimile types ('uses'), -->
<!-- and that projects might come up with new ones, or specialize existing ones -->
<!-- as in the "very-small-thumbnail" below, which would mean providing a basic -->
<!-- taxonomy which would be shared and part of the guidelines, while allowing -->
<!-- extension -->
<!-- how to use with tei:ref/@type? or replace tei:ref below with something else? -->
<bibl>
<ref target="{pointer to a standard taxonomy of basic facsimile roles/relationships}"/>
</bibl>
<category xml:id="text">
<catDesc>Textual form</catDesc>
</category>
<category xml:id="thumbnail">
<catDesc>Thumbnail image</catDesc>
<category xml:id="very-small-thumbnail">
<catDesc>Extra small thumbnail</catDesc>
</category>
</category>
<category xml:id="access">
<catDesc>Large image</catDesc>
</category>
<category xml:id="annotation">
<catDesc>Large annotated image</catDesc>
</category>
</taxonomy>
...
<facsimileStmt>
<facsimileList><!-- list of facsimile images, inline or external -->
<graphic xml:id="thumb-p1" url="thumb-p1.jpg" mimeType="image/jpeg"/>
<graphic xml:id="access-p1" url="access-p1.jpg" mimeType="image/jpeg"/>
...
<svg:svg xml:id="detail-unclear-22" xmlns:svg="http://www.w3.org/2000/svg">
<!-- svg image could be zoomed and cropped here to a detail -->
<svg:image id="svg1-access-p1-detail" x="0" y="0" width="100" height="100"
xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="access-p1.jpg"/>
</svg:svg>
...
</facsimileList>
<facsimileLinks>
<facsimileLink><!-- group of links to equivalents -->
<ref type="text" target="#pb1"/>
<ref type="thumbnail" target="#thumb-p1"/>
<ref type="access" target="#access-p1"/>
<ref type="annotation" target="#annotation-p1"/>
</facsimileLink>
<facsimileLink>
<ref type="text" target="#unclear-22"/>
<ref type="access" target="#detail-unclear-22"/>
</facsimileLink>
...
</facsimileLinks>
</facsimileStmt>
...
</teiHeader>
