Specifying Long Descriptions for Images in Word
To assign a long description to an image, your Stationery and template must have the ImageLongDescText marker type configured. Your output format must also support this feature.
When you use the ImageLongDescText marker to assign long descriptions to images, ePublisher generates an external text file that contains the long description you specify. When a conformant screen reader application reads the generated page, it loads the .txt file referenced in the longdesc attribute on the page and reads the file.
The following procedure provides an example of how to specify long descriptions for images in Microsoft Word source documents using Microsoft Word 2003. Steps for specify long descriptions for images in Microsoft Word may be different in other versions of Microsoft Word.
To assign a long description to an image using marker text in a Microsoft Word source document
1. In your Microsoft Word source document, locate the image to which you want to assign a long description.
2. Right-click the image, and then click Format Picture or Format Object.
3. Change the layout setting of the image to Top and Bottom by completing the following steps:
Note: By default when you insert images into Microsoft Word, Microsoft Word inserts the image using the Inline with text layout setting. In order to specify the image scale for image output files, you must group the image and the text box that contains the ImageLongDescText marker. However, you cannot group images using the In line with text layout setting in Microsoft Word. To work around this known Microsoft Word issue, if you have an image that uses an In line with text layout setting, use the Top and Bottom layout setting for the image while you insert the ImageLongDescText marker, and then reapply the In line with text layout setting after you group the image and the ImageLongDescText marker.
a. On the Layout tab, click Advanced.
b. On the Text Wrapping tab, click Top and Bottom.
c. Click OK, and then click OK again to close the window.
4. Select your image.
5. On the Insert menu, click Text Box, and then click to the right of your image. Microsoft Word inserts a text box.
6. Insert your cursor into the text box, and then complete the following steps:
a. On the WebWorks menu, click Markers.
b. In the Markers field, select ImageLongDescText from the list of markers.
c. In the Value field, type the long description you want to specify for the image.
d. Click OK. ePublisher inserts the ImageLongDescText marker into the text box.
e. Select the text box.
f. Right-click the selected text box, and then click Format Text Box.
g. On the Colors and Lines tab, in the Fill area, in the Color field, select No Fill.
h. In the Line area, in the Color field, select No Line.
i. Click OK.
7. Drag and drop the text box onto the image.
8. Select the text box and the image.
9. Right-click the selected text box and image, and then click Grouping > Group.
Note: When you select Group, the location of the image in your Microsoft Word source document may change in relation to the text in your source document. For example, the image may move up or down in your Microsoft Word source document. This is known Microsoft Word behavior. You may need to scroll up or down in your source document to the new location of the image to find the image.
10. If your image previously used the In line with text layout setting for the image, reassign this style to your image by completing the following steps:
a. Right-click only the image, and then click Format Object.
Note: You must ensure you right-click only the image, and not on the text box or the grouped text box and image. If you right-click on the text box or the grouped text box and image, Microsoft Word does not display the Format Object menu option on the context menu.
b. On the Layout tab, click In line with text.
c. Click OK, and then click OK again to close the window.
11. Save your Microsoft Word source document.
13. Verify ePublisher assigned the long description to the image by completing the following steps:
a. On the View menu, click Output Directory.
b. In the TargetName\images folder, verify that ePublisher created a .txt file that contains the long description you specified in the ImageLongDescText marker, where TargetName is the name of your target.
For example, if you specified a long description for ImageName.png, verify that ePublisher created an ImageName.txt file in the images folder, where ImageName is the name of the image to which you assigned a long description.
c. In the TargetName\ProjectName folder, open the page that contains the image to which you assigned the long description in Notepad and verify that the longdesc attribute references the ImageName.txt file ePublisher created for the image, where TargetName is the name of your target, ProjectName is the name of your project, and ImageName is the name of the image to which you assigned a long description.
d. If you used the ImageLongDescText marker and the Stationery designer configured your Stationery to support D links, open the page in a browser, verify that the D link displays in the browser, and then click the D link and verify that a page opens that displays the long description that you specified in the ImageLongDescText marker.