[bksvol-discuss] Re: Qustion on manual

  • From: Scott Rains <scottr@xxxxxxxxxxxx>
  • To: "bksvol-discuss@xxxxxxxxxxxxx" <bksvol-discuss@xxxxxxxxxxxxx>
  • Date: Mon, 21 Nov 2011 09:48:35 -0800

This discussion is good for purposes of clarification. The consensus has been 
that simpler and shorter is better thus avoidance of "image" after the opening 
square bracket.

At the same time, keep in mind that bracketed captions or image descriptions 
inside the text will fade away. As we adopt the image description methodology 
behind Benetech's Poet tool this material will no longer disrupt the book text. 
It will be embedded in the .xml. That way the DAISY reader can be set to show 
or hide the added material. Depending on the manufacturer these third party 
products may or may not alert the reader with a phrase like, "Start caption."

Scott Rains
Bookshare
To: "bksvol-discuss@xxxxxxxxxxxxx<mailto:bksvol-discuss@xxxxxxxxxxxxx>" 
<bksvol-discuss@xxxxxxxxxxxxx<mailto:bksvol-discuss@xxxxxxxxxxxxx>>
Subject: [bksvol-discuss] Re: Qustion on manual

Hi, makes perfect sense to me. Call the thing what it is. If the caption is a 
caption, why not just say "picture caption" to get rid of confusion? Regards, 
Kim Friedman.
-----Original Message-----
From: 
bksvol-discuss-bounce@xxxxxxxxxxxxx<mailto:bksvol-discuss-bounce@xxxxxxxxxxxxx> 
[mailto:bksvol-discuss-bounce@xxxxxxxxxxxxx] On Behalf Of Doug Maples
Sent: Saturday, November 19, 2011 8:02 PM
To: bksvol-discuss@xxxxxxxxxxxxx<mailto:bksvol-discuss@xxxxxxxxxxxxx>
Cc: 'Scott Rains'
Subject: [bksvol-discuss] Re: Qustion on manual

I totally agree with Valerie. When I see something inside of brackets with the 
image: at the beginning, I would just assume that whatever is inside of quotes 
has something to do with the image description. I would never know that was a 
caption. I firmly believe that the caption should have caption: before it. 
Otherwise, how are you going to know?

– Doug

From: 
bksvol-discuss-bounce@xxxxxxxxxxxxx<mailto:bksvol-discuss-bounce@xxxxxxxxxxxxx> 
[mailto:bksvol-discuss-bounce@xxxxxxxxxxxxx] On Behalf Of Valerie Maples
Sent: Saturday, November 19, 2011 4:58 PM
To: bksvol-discuss@xxxxxxxxxxxxx<mailto:bksvol-discuss@xxxxxxxxxxxxx>
Subject: [bksvol-discuss] Qustion on manual

Vivian mentioned she had found in the volunteer manual to simply enclose a 
caption in quotes, as mentioned here:

https://wiki.benetech.org/display/BSO/4.8+Y.+Format+for+image+description+tags#4.8Y.Formatforimagedescriptiontags-formattouseforimagedescriptionswithcaptions

The example given is:
 [image: A young boy in mid-air as he dives off a pier into a small lake. 
Already in the water is an older man, standing and smiling.
"Having fun on hot days."]

But I have always done it like this:

 [image: A young boy in mid-air as he dives off a pier into a small lake. 
Already in the water is an older man, standing and smiling.
caption: Having fun on hot days.]


I can develop new habits, but to me, the other is more clear, espcially if the 
caption is a quote already in quotation marks.  Is there a reason for the 
change?

Valerie

Keep up with Nichole's recovery:
http://www.caringbridge.org/visit/nicholemaples

Other related posts: