=======Complex Image Description Section=======

[French: //Descriptions d'images complexes//]

The ''Complex Image Descriptions'' section goes at the end of the book, before the Terms of Use section,  and it is where you place your complex descriptions.

We create longer, complex descriptions for any image that contains complex information or data. Common examples are Maps, Graphs, Charts and Diagrams. We can also create longer, complex descriptions when we need to transcribe an image, such as an image of a letter. If you are not sure if your image requires a complex description, ask in the [[public:nnels:etext:q_a|Q&A Section]].

For images that require more complex or extended descriptions we create two descriptions:

  - Simple Image Description summarizing the image in Alt-Text Description Box ending with the ''See the link below the image for an extended description.'' Note: This can be just one or two sentences, as the Long Description will go into the details.
  - Long Description in the Complex Image Descriptions Section with links back to the image being described.

<note important>You must include a shorter image description in the Alt-text box that compliments the longer description. Remember, all images must have Alt-text.</note>

======Creating Section: Headings, Bookmarks and Hyperlinks=====

First you want to create the main section for these longer descriptions. Do the following:
Section title is Complex Image Descriptions. Apply ''Heading Style 1'' to heading.
Place the section in the back matter of the book //before// the [[public:nnels:etext:terms-of-use|Terms of Use]] section.
Below this heading add the following text: ''Below you will find the complex descriptions for images in the text.''
Make sure this text is styled as ''Normal''
Subheadings for each image description go below this text

<note>False navigation can happen when there is no content between headings (usually normal style text). A screenreader user will think they have missed information. Unfortunately, **we are not editors** so we can not fix this if it happens in the main book content of the title we are reformatting. But, we do create the Complex Image Descriptions section, so we can avoid this problem by following the above documentation.</note>

<note>Don't forget to include a brief description in the Alt-text box for the image ending with ''See the link below the image for an extended description.''</note>

====Setting Up Subsection Headings and Text====

You need to set up your headings and the text before you can create the internal navigation.

===Add Text Below Image===

For the Image:
  * Locate the image in the text that requires a complex description
  * Below the Image and Caption add the text:  ''Follow this link for an extended description at the end of the book.'' or for french books ''Suivez ce lien pour une description détaillée à la fin du livre.''
  * Style as ''Normal''

<WRAP center round box 80%>
**Example**
{{ :public:nnels:etext:manitoba_map_sample_description.png?400 |}}
Caption text

Follow this link for an extended description at the end of the book.

Body text of book.
</WRAP>

===Add Subheadings and Navigation Text for Descriptions===

Next you have to add subsection headings for each long description.
  * Locate the Complex Image Descriptions section
  * Create a subheading section in ''Heading 2'' style
  * Title the section ''Description of ___''
     * e.g. Description of Map for Number of Cars Registered in 1912

Under this subheading insert the image you are describing before the long description. To set an image as decorative:
  * Left click the image.
  * Select View Alt-text
  * This will open the Alt-text pane to the right of your work area
  * Below the Alt-text box there is the option to ''Mark as Decorative''
  * Select this option

<note>We enter the images in this section for people who are low vision or have cognitive reading disabilities. We mark them as decorative so the screenreader users do not find an image without Alt-text. </note>

Your complex description goes below the image, and the navigational text to return to the book goes below your description.
  * Enter your complex description in this section. See [[public:nnels:etext:images:complex_images|Complex Images and Long Descriptions]] on how to write Alt-text.
  * At the end of the description enter the text: ''Navigate back to image.'' or for French books ''Retournez à l'image.''
  * Style as ''Normal''

<WRAP center round box 80%>
**Example**

Complex Image Descriptions [heading 1]

Below you will find the complex descriptions for images in the text. [Normal]

Description of Map for Number of Cars Registered in 1912 [heading 2]
{{ :public:nnels:etext:manitoba_map_sample_description.png?400 |}}
(Image set to decorative)

Map depicting vehicle ownership in Southern Manitoba. The title of the map reads: Number of Cars Registered in 1912. There is a legend that shows red circles of increasing size with a white car icon in the center of the circle. Each circle represents a number of cars. The smallest circle is 1-5, then next size up is 6-10, then 11-25, then 26-100, then 101-1000 then 1001-2025.

The map shows Manitoba with all the major cities and towns labelled with a variety of different sized red circles, mainly over the southern part of the province. The main areas are highlighted as follows: Winnipeg, represented by the circle for 1001-2025 cars, and Brandon, represented by the circle for 101-1000 cars, have the largest circles. Dauphin, Virden, Neepawa, Carberry, Portage La Prairie are represented by the circle for 26-100 cars. Russell, Minnedosa, Gladstone, Souris, Deloraine, Boissevain, Crystal City, Morden, and Winkler are represented by the circle for 6-10 cars. [Normal]

Navigate back to image.[Normal]
</WRAP>

[[https://screencast-o-matic.com/watch/cY1bFcCkK5|Here is a quick tutorial of how to do this]].

====Adding Links and Bookmarks====

Now that you have set up the Headings and text you are ready to create the navigation for this section by using the Bookmark and Internal Links features.

First you will need to create your ''link'' to the description section.

  * Locate the image for the complex description
  * Highlight the phrase''Follow this link for an extended description at the end of the book.''
  * Right click to open the popup menu
  * Select ''Hyperlink''
  * This will open a popup window ''Insert Hyperlink''
  * Select the ''This Document'' tab
  * Open up the drop menu for ''Headings''
  * Open up the drop menu for ''Complex Image Descriptions'' and select the sub-heading for the complex description to link to.
     * Example: Headings>Complex Link Descriptions> Description of Map for Number of Cars Registered in 1912

This will create your link from the image to the correct description sub-heading in the Complex Image Descriptions section.

Next you will need to set up the return link.

First insert a ''bookmark'' as an anchor for the return link.

For the Return Link Bookmark:
  * Locate the image for your complex description
  * Highlight the image
  * Go to the ''Insert'' Menu
  * Locate the ''Links'' Section
  * Select ''Bookmark''
  * A popup window will appear
     *In the ''Bookmark name'' field enter an identifying name for the image, so you know what image goes with what description.
     *NOTE: It //must// have no spaces
        *Example: ReturntoMapManitobaVehicles
     * Select ''Add''
  * You now have a bookmark for your return link!

<note>You //must// insert the bookmark //before// you insert the return hyperlink or it will not work.</note>

<note tip>Make sure to give each bookmark a unique and identifiable name. This will help you keep track if you have multiple bookmarks in a single etext.</note>

If you have any questions ask in the [[public:nnels:etext:q_a|Q and A section]].

Now that you have created your bookmark, you are ready to create your return to image link.

For the Return to Image Link:
  * Locate the description in Complex Image Descriptions
  * Highlight the phrase "Navigate back to image."
  * Right click to open the popup menu
  * Select ''Hyperlink''
  * This will open a popup window ''Insert Hyperlink''
  * Select the ''This Document'' tab
  * Under ''Bookmarks'' open the dropdown menu and select the bookmark you created for the //return to image//
     * Example: select "MapofManitobaRoadMap"


[[https://screencast-o-matic.com/watch/cY1qqqCJw5|Here is a quick tutorial showing you how to do this.]]

<note tip>You can set your bookmarks to be visible to help you keep track of where they are in your document.

For ''Window's PC'': Open the Options Dialogue box through File>Options and select the Advanced section. Scroll down to the Show Document Content section and make sure ''Bookmarks'' is selected. Click OK. You will now see a square bracket beside the location of your bookmark.

For ''Mac'': Open the Words Preferences box through Word>Preferences and select View. Make sure ''Bookmarks'' is selected. Close the window. You will now see a square bracket beside the location of your bookmark.</note>

If you ever find you made a mistake and need to delete a bookmark do the following:
  * Locate the bookmark you need to delete
  * Place your cursor in the etext
  * Go to the ''Insert'' Menu
  * Locate the ''Links'' Section
  * Select ''Bookmark''
  * A popup window will appear
  * Click and highlight the bookmark you wish to delete
  * Select ''Delete''

<note>On how to write long descriptions go to [[public:nnels:etext:images:complex_images|Complex Images and Long Descriptions]].</note>

<note tip>If you have any questions, post your question on the [[public:nnels:etext:q_a|Production Q&A]]
</note>


[[public:nnels:etext:start|Return to main eText Page]]