| Both sides previous revision
Previous revision
Next revision
|
Previous revision
Next revision
Both sides next revision
|
public:nnels:etext:producers-note [2020/04/20 12:30]
rachel.osolen [Heading 1 Section Producer's Note] |
public:nnels:etext:producers-note [2020/06/30 09:38]
rachel.osolen [Q&A] |
| ====In-Text Producer's Note==== | ====In-Text Producer's Note==== |
| |
| Sometimes we will need to insert a producer's note within the body of the text; for example, to describe or interpret visual elements in the text where the alt text might not be sufficient. In this case, we mark up the text using the **Prodnote - Optional (DAISY)** style. | Sometimes we will need to insert a producer's note within the body of the text. This is what is called an In-Text Producer's Note. |
| |
| We will also surround our producer's note with the text: BEGIN PRODUCER'S NOTE and END PRODUCER'S NOTE. This is so that readers of the e-text version will know that this is not part of the normal narrative. | A common instance is when there is Alt-text that is longer than the recommended 120 words. When this happens, the longer Alt-text should be put into a Producer's Note. (Be sure to also include a short description in the alt-text). For more information, see [[public:nnels:etext:images#adding_extended_image_descriptions_producer_s_notes|Adding Extended Image Descriptions]] for more information. Often, this will be for something like a picture of a letter, a map, or a graph. |
| |
| One instance where an in-text Producer's note will be used is when there is alt-text that is longer than 120 words. When this happens, the description should be put into a Producer's Note. (Be sure to also include a short description in the alt-text). For more information, see [[public:nnels:etext:images#adding_extended_image_descriptions_producer_s_notes|Step 8]] of the alt text instructions. Often, this will be for something like a picture of a letter, a map, or a graph. | <note>For Long and Complex Descriptions use the ''Prodnote - Optional (DAISY)'' so the reader has the option to skip it.</note> |
| |
| <note>In-Text Producer's Notes must be identified as "required" or "optional", using the appropriate style from the NNELS template (''Prodnote - Optional (DAISY)'' or ''Prodnote - Required (DAISY)''). 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 Producer's Note whether it contains critical information and is thus marked as "required" or merely contains helpful information that an end user could skip without harm. If there's uncertainty whether to use the "optional" or "required" attribute, use "required", or ask for advice. | Other cases where this style is used are highlighted throughout the wiki. |
| </note> | |
| | In-Text Producer's Notes are marked up the text using the ''Prodnote - Optional (DAISY)'' or ''Prodnote - Required (DAISY)''. |
| | |
| | <note>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 PA must decide for each Producer's Note whether it contains critical information that is required, or information that can be skipped, and therefore optional. If there's uncertainty whether to use the ''Prodnote - Optional (DAISY)'' or ''Prodnote - Required (DAISY)'' use "required", or post a question in the Q&A.</note> |
| | |
| | When writing the content of a In-Text Producer's Note, always start the text with ''BEGIN PRODUCER'S NOTE'' and finish the text with ''END PRODUCER'S NOTE'' (see the example below). |
| | |
| | This is so that readers will know that this is not part of the normal narrative. |
| | |
| | |
| | <WRAP center round box 80%> |
| | **Example** |
| |
| ===Example=== | |
| This is an example of an in-text producer's note used to describe a diagram of a family tree (the diagram is depicted smaller than it would be in the actual text). | This is an example of an in-text producer's note used to describe a diagram of a family tree (the diagram is depicted smaller than it would be in the actual text). |
| |
| {{:public:nnels:prodnote_example1.png?direct&500|}} | {{:public:nnels:prodnote_example1.png?direct&500|}} |
| | </WRAP> |
| | |
| |
| ====Q&A==== | ====Q&A Archive==== |
| |
| **Q: In a book where the original front-matter includes a description of the typefaces used (i.e., "The text in this book uses OpenDyslexic and Minion Pro typefaces."), should this be removed? Or addressed in a "Producer's Note?"** | **Q: In a book where the original front-matter includes a description of the typefaces used (i.e., "The text in this book uses OpenDyslexic and Minion Pro typefaces."), should this be removed? Or addressed in a "Producer's Note?"** |
| |
| A: Yes, we can address this in a Producer's Note [Heading 1]. We could state something to the effect that "the text is this Digital Talking Book does not use OpenDyslexic and Minion Pro typefaces. These typefaces are used in the original book." | A: Yes, we can address this in a Producer's Note [Heading 1]. We could state something to the effect that "the text is this Digital Talking Book does not use OpenDyslexic and Minion Pro typefaces. These typefaces are used in the original book." |
