<index-see>

An <index-see> element directs the reader to an index entry that the reader should use instead of the current one.

Usage information

There can be multiple <index-see> elements within an <indexterm> element.

Processing expectations

Processors SHOULD ignore an <index-see> element if its parent <indexterm> element contains any <indexterm> children.

Content model

(Text | <data> | <sort-as> | <foreign> | <unknown> | <keyword> | <term> | <text> | <ph> | <strong> | <em> | <b> | <i> | <line-through> | <overline> | <sup> | <sub> | <tt> | <u> | <indexterm> )*

Attributes

The following attributes are available on this element: universal attributes and @keyref.

Examples

This section contains examples of how <index-see> elements can be used.

Figure 1. Use of an <index-see> element

The following code sample shows how an <index-see> element is used to refer readers to the preferred term:

<indexterm>Carassius auratus
  <index-see>goldfish</index-see>
</indexterm>

This markup will generate an index entry without a page reference. It might look like the following:


This screen capture shows a portion of a generated index. The reader is instructed to look in the index for the vernacular term goldfish, rather than the Latin Carassius auatus. The edges of the screen capture are tattered, to indicate that the image is part of a larger document.
Figure 2. Use of an <index-see> element to redirect to a multi-level index entry

The following code sample shows how an <index-see> is used to redirect to a multilevel index entry:

<indexterm>feeding goldfish
  <index-see>goldfish
    <indexterm>feeding</indexterm>
  </index-see>
</indexterm>