Images

Treatment of images in EB11 files from Project Gutenberg.

(v2 only) Include images by linking to them. Use the following pattern:

<figure>
    <graphic url="pullman.png"/>
    <head>Fig. 3</head>
    <p>The drawing room of the Pullman house, the white and gold saloon
    where the magnate delighted in giving receptions for several hundred
    <figDesc>The figure shows an elaborately decorated room, at least
    twenty-five feet side to side and fifty feet long</figDesc>
    <ab type="attribution">From J. Brown, Architecture<\ab>
</figure>
  • Use <figure> to enclose all elements of the image, including any text related to it.
  • <graphic> includes @url to link to the image file. Images are out-of-scope in v1, so use # for the attribute value.
  • For text identifying the image, use <head> regardless of whether it is above or below the image.
  • Use <p> for the original gloss on the image.
  • For an alt-text describing then image for people who cannot view it, use <fileDesc>. This text is supplied by the encoder.
  • For image attributions (usually in very small type), use <ab type="attribution">

Usage notes:

  1. Try not to break paragraphs. Instead, move <figure> before or after the paragraph.
  2. Do not use <caption>. That's reserved for performance texts, like a film script.
  3. For full-page plates, remove any eclectic encoding, such as [illo], and comment out the text:
    • <!-- Map of Alaska -->