User talk:Martin de la Iglesia/A Guide to Images in TEI

General

Suggested use of this page

The idea is to start by filling in the different chapters in Outline below. In the beginning, I think it makes sense to do this in a Discussion page, in order to avoid switching back and forth between the Article and the Discussion page all the time. After some time we can move the text from the Discussion page to my namespace, then after some more consolidation to the main wiki. Finally, we could move it to an entirely different website if we found the TEI Wiki unsuitable. However, feel free to suggest other procedures, or maybe an entirely different environment for working on this resource altogether. --Martin de la Iglesia 06:47, 2 December 2011 (EST)

Title

The title of this page (currently: "A Guide to Images in TEI") is just a working title. Feel free to suggest alternative titles. --Martin de la Iglesia 06:47, 2 December 2011 (EST)

Related resources

We should think about how this resource relates to TEI to SVG (and maybe other relevant pages/resources), and whether and how this information should be integrated here. --Martin de la Iglesia 06:47, 2 December 2011 (EST)

Outline

Aims and Scope

We should have a text here which explains what this resource is for and how it differs from the TEI Guidelines. In the meantime, I paste my announcement e-mail to the SIG Text & Graphics mailing list from December 1, 2011:

[...]

I learned in Würzburg that some other SIGs are planning to create specialized tutorials that cover aspects relevant to the respective SIG's scope which are not already covered by general introductory TEI resources like TEI By Example. This sounds like a good idea for our SIG, too. I'm aware that, basically, the solutions are all in the TEI Guidelines somewhere, but as we all know, it can be quite tough to make encoding decisions by only consulting the Guidelines. This is especially true for the encoding of graphics-related information, which, as far as I have seen, is not well covered by TEI By Example.

In addition to the examples given by John, I'd like this new FAQ/Tutorial to tackle basic questions such as

- how to encode the position of images on a page

- how to link images to text

- how to align images with portions of text or vice versa

- how to encode descriptions of images or other image metadata

etc.

So what I'm envisioning is a sort of beginner's guide to handling images in TEI, either as a FAQ (i.e. self-contained chapters) or a step-by-step Tutorial (i.e. "what to do when you encounter an image in your text"). As John already mentioned, integration into TEI By Example might also be a possibility (although I haven't discussed this idea with the TEI By Example people yet).

[...]

--Martin de la Iglesia 04:11, 5 December 2011 (EST)

Basic Integration of Images/Linking to Images

John (Walsh) suggested covering the <figure> tag. Additionally, it might be useful to have a general discussion on image types (binary vs. SVG vs. characters (i.e. trying to find matching Unicode characters for special symbols instead of integrating them as images)) and the different encoding practices they imply. --Martin de la Iglesia 04:18, 5 December 2011 (EST)

Linking to Facsimile Page Images

This is another topic suggested by John ("using <facsimile> and @facs to link to facsimile page images"). --Martin de la Iglesia 04:23, 5 December 2011 (EST)

You might draw upon this section of the Best Practices for TEI in Libraries. (Kshawkin 08:26, 2 December 2011 (EST))

Thanks, Kevin. I wasn't aware of that section. There's one thing I don't understand about the third approach: in the sample METS document, which is the ID that is used in @xml:id in the TEI code? --Martin de la Iglesia 05:35, 7 December 2011 (EST)

Positioning an Image

What I'd like to see here is a discussion of the <surface>/<zone> coordinate positioning system vs. <ptr>-like positioning solutions, and maybe of other systems as well (e.g. lines and margin for y and x axis positioning). --Martin de la Iglesia 04:28, 5 December 2011 (EST)

Image-Text Linking

This section should cover the encoding of different kinds of image-text relationships (e.g. an image illustrating a text paragraph, or a text paragraph describing an image), other than merely topographical ones which are covered in the following section, Image-Text Alignment. --Martin de la Iglesia 04:40, 5 December 2011 (EST)

Image-Text Alignment

How to position text relative to an image, or an image relative to text (including special cases such as an image pointing at a character, or an image pointing at two separate characters) should be covered here. --Martin de la Iglesia 04:43, 5 December 2011 (EST)

Image Metadata

I'm thinking primarily of content description texts, but we could embed this in a general discussion of how (or whether) to encode any "invisible" aspects of images. --Martin de la Iglesia 04:34, 5 December 2011 (EST)