Excluding Images from Accessibility Report Checks in Word
NOTE TO REVIEWERS: This section has some problems. If you use this marker, it only seems to recognize image longdesctext markers. It does not recognize imagelongdescbyref markers. Images still show up as not having a long description, even though the long description displays correctly.
In some instances, alternate text is sufficient for an image, and assigning a long description to an image in addition to alternate text would be redundant. However, you may have configured Accessibility reports to check for images without long descriptions and notify you when an image does not have a long description.
In this scenario, while you want an Accessibility report to notify you when you have an image without a long description, you do not want to be notified when you deliberately did not assign a long description to an image because assigning a both a long description and alternative text would be redundant. To address this issue, you can use the ImageLongDescNotReq marker to exclude an image that deliberately does not have a long description from validation when you generate Accessibility reports. For more information about Accessibility reports and configuring and generating Accessibility reports, see
Accessibility Reports,
Configuring Reports, and
Generating Reports.
To exclude images without long descriptions from Accessibility reports, your Stationery and template must have the ImageLongDescNotReq marker type configured. Your output format must also support this feature.
The following procedure provides an example of how to exclude images without long descriptions from Accessibility report checks in Microsoft Word source documents using Microsoft Word 2003. Steps for excluding images without long descriptions from Accessibility report checks in Microsoft Word may be different in other versions of Microsoft Word.
NOTE TO REVIEWERS: These steps work. However, when you run accessibility reports, if you use a ImageLongDescTex marker, everything works fine. But when you run accessibility reports using an ImageLongDescByRef marker, it looks like this marker is not picked up, and even when you assign an image long description using the ImageLongDescByRef marker, it still gets flagged with a warning when you run an Accessibility report.
To exclude an image without a long description from Accessibility report checks in a Microsoft Word source document
1. In your Microsoft Word source document, locate the image without a long description that you want to exclude from an Accessibility report check.
2. 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 ImageLongDescNotReq 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 ImageLongDescNotReq marker, and then reapply the In line with text layout setting after you group the image and the ImageLongDescNotReq 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.
3. Select your image.
4. On the Insert menu, click Text Box, and then click to the right of your image. Microsoft Word inserts a text box.
5. 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 ImageLongDescNotReq from the list of markers.
c. In the Value field, do not enter any text. You do not need to enter any text in this field when you insert a ImageLongDescNotReq marker.
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.
6. Drag and drop the text box onto the image.
7. Select the text box and the image.
8. 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.
9. 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.
10. Save your Microsoft Word source document.
12. Generate an Accessibility report and confirm that ePublisher did not generate an
Image is missing a long description message for the image. For more information about generating Accessibility reports and Accessibility report messages, see
Generating Reports and
Accessibility Report Messages.