DAISY—Structure Guidelines: Elements, Block Elements, Information Object Producer’s Note

DAISY—Structure Guidelines: Elements, Block Elements, Information Object Producer’s Note

Information Object

Producer’s Note

Definition

Information added to the DAISY DTB by the producing organization; commonly used to provide descriptions of visual elements such as charts, graphs, etc., supply operating instructions, or describe differences between the print book and the audio version. Traditionally, this has been called a transcriber’s note, reader’s note, or editor’s note.

Markup

Producer’s notes are marked with the <prodnote> tag and must be identified as required or optional using the “render” attribute. Optional producer’s notes may be turned on or off by the end user; that is, the playback device or browser includes settings that either automatically play all producer’s notes as they are encountered or play only those marked as required. The producer must decide for each <prodnote> whether it contains critical information and is thus marked as required or merely contains helpful information that an end user could skip without harm.

A <prodnote> may contain bare text, inline or block level elements such as <p>.

The “showin” attribute can be used to control in which of three media types a given <prodnote> will be displayed. The allowable values for showin are xxx, xxp, xlx, xlp, bxx, bxp, blx, and blp, where x = inappropriate, b = braille, l = large print, and p = print. Thus the value “xlp” would prompt a player to display the prodnote in large print or print versions, but not in braille.

See Inline Elements: Information Object: Producer’s Note for an example of <prodnote> used as an inline element.

Syntax

<prodnote render="...">

...

</prodnote>

Example 1

<prodnote render="required">

The question below refers to a picture showing three glasses. The first

glass is 1/4 full, the second glass is 1/2 full and the third is 3/4 full.

</prodnote>

Example 2

<prodnote render="optional">

The map on this page shows all the cities in Europe with a population of more

than 100,000.

</prodnote>

Tags: DAISY