StrawManFacsimileMarkup

From TEIWiki
Revision as of 09:28, 25 July 2006 by Conal (talk | contribs) (v2)
Jump to navigation Jump to search

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 facsimile images -->
	<pg xml:id="pg1" from="#pb1" to="#pb2" width="100mm" height="120mm">
		<!-- @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 might allow svg:svg here -->
	</pg>
	<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>