Difference between revisions of "StrawManFacsimileMarkup"

From TEIWiki
Jump to navigation Jump to search
(v2)
(v2)
Line 32: Line 32:
  
 
...
 
...
<!-- list of facsimile images -->
+
<!-- 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">
 
<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 -->
 
<!-- @graphicType allows classification of graphics by resolution, equipment, or suitability for purpose -->
 
<!-- xml:id, url, and mimeType are all existing attributes of tei:graphic -->
 
<!-- xml:id, url, and mimeType are all existing attributes of tei:graphic -->
Line 42: Line 47:
 
match the size of the page, they would have leftX and leftY equal to 0. If the scans included white space
 
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. -->
 
around the edge of the physical pages, then the values would be negative. -->
 +
 
<graphic  
 
<graphic  
 
facsimileType="#thumbnail"  
 
facsimileType="#thumbnail"  
Line 62: Line 68:
 
width="80mm"
 
width="80mm"
 
height="100mm"/>
 
height="100mm"/>
<!-- an SVG customisation might allow svg:svg here -->
+
<!-- an SVG customisation should allow svg:svg here -->
 
</pg>
 
</pg>
 +
 +
<!-- more pages ... -->
 
<pg xml:id="pg2" from="#pb2" to="#pb3" width="100mm" height="120mm">
 
<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="#thumbnail" xml:id="thumb-p2" url="thumb-p2.jpg" mimeType="image/jpeg"/>

Revision as of 09:34, 25 July 2006

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>