Difference between revisions of "StrawManFacsimileMarkup"

From TEIWiki
Jump to navigation Jump to search
m (+ category)
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
=v v3 =
 
<pre>
 
<pre>
 +
<TEI>
 
<teiHeader>
 
<teiHeader>
  
Line 11: Line 13:
 
<bibl>
 
<bibl>
 
<ref target="{pointer to a standard taxonomy of basic facsimile roles/relationships}"/>
 
<ref target="{pointer to a standard taxonomy of basic facsimile roles/relationships}"/>
<category xml:id="text">
+
</bibl>
<catDesc>Textual form</catDesc>
+
<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="thumbnail">
+
</category>
<catDesc>Thumbnail image</catDesc>
+
<category xml:id="access">
<category xml:id="very-small-thumbnail">
+
<catDesc>Large image</catDesc>
<catDesc>Extra small thumbnail</catDesc>
+
</category>
</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>
 +
</pre>
 +
= v2 =
 +
<pre>
 +
<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">
+
</category>
<catDesc>Large image</catDesc>
+
<category xml:id="access">
</category>
+
<catDesc>Large image</catDesc>
<category xml:id="annotation">
+
</category>
<catDesc>Large annotated image</catDesc>
+
<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>
 +
</pre>
 +
 
 +
= v1 =
 +
<pre>
 +
<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>
</bibl>
+
</category>
 +
<category xml:id="access">
 +
<catDesc>Large image</catDesc>
 +
</category>
 +
<category xml:id="annotation">
 +
<catDesc>Large annotated image</catDesc>
 +
</category>
 
</taxonomy>
 
</taxonomy>
  
Line 60: Line 257:
 
</teiHeader>
 
</teiHeader>
 
</pre>
 
</pre>
 +
 +
[[Category:Facsimiles|StrawMan]]

Latest revision as of 00:13, 6 April 2007

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>