<index-term>
Index Term
The index term to be embedded into the narrative of an article so that an Index can be created programmatically.
Remarks
Embedded index terms are more frequently a feature of books than they are of journal articles, but some publishers are now placing index terms in the text of a journal article so that both issue indexes and online article indexes can be made.
Structure of an Index Term: Index entries are recursive, so if a category (“drinks”) contains a
sub-category (“lemonade”), the category
<index-term> will contain two components:
- its own <term> (“drinks”), and
- an <index-term> for the sub-category. This subordinate index term will contain its own <term> (“lemonade”).
<index-term>
<term>drinks</term>
<index-term>
<term>lemonade</term>
</index-term>
</index-term>
Terms Points and Term Ranges: An <index-term> is either a single target point or the
start of an index range. When it is the start of a range, an @id attribute is required, so
that the <index-term-range-end> element can point to the start of the range.
Attributes
Content Model
<!ELEMENT index-term %index-term-model; >
Expanded Content Model
(term, (index-term | (see | see-also)*))
Description
The following, in order:
- <term> Definition List: Term
- Any one of:
- <index-term> Index Term
- Any combination of:
This element may be contained in:
<addr-line>, <alt-title>, <article-title>, <attrib>, <award-id>, <bold>, <code>, <collab>, <comment>, <conf-theme>, <def-head>, <element-citation>, <fixed-case>, <funding-source>, <index-term>, <italic>, <license-p>, <meta-value>, <mixed-citation>, <monospace>, <named-content>, <overline>, <p>, <preformat>, <product>, <roman>, <sans-serif>, <sc>, <see>, <see-also>, <strike>, <styled-content>, <sub>, <subtitle>, <sup>, <supplement>, <support-source>, <td>, <term>, <term-head>, <th>, <title>, <trans-subtitle>, <trans-title>, <underline>, <verse-line>
Example 1
An index term, complete with its See Also reference, inside narrative text:
...
<p>However, the First Amendment does not bar the
issuance or execution of a warrant to search a
newsroom<index-term><term>Newspapers</term>
<see-also><index-term><term>Speech and press</term>
</index-term></see-also></index-term> to obtain
photographs of demonstrators who had injured several
policemen, although the Court appeared ...</p>
...
Example 2
An index term, complete with its See reference, inside a title:
...
<sec id="sec10-3-3">
<title>United States Interstate Compacts<index-term id="idx313">
<term>Interstate compacts</term>
<see><index-term><term>States, Agreements with other States</term>
</index-term></see>
</index-term></title>
<p>For many years after the United States Constitution was adopted, boundary
disputes continued to predominate as the subject matter of agreements
among the States. Since the turn of the twentieth century, however, the
interstate compact has been used to an increasing extent as an instrument
for state cooperation ...</p>
...
</sec>
...
Example 3
An index term (with both See and See Also references) which uses vocabulary attributes:
... <p>Fu attribuito prevalentemente ad Aristotele<index-term index-type="person" id="idx108"> <term vocab-term-identifier="http://xmlns.com/foaf/spec/#term_Person" >Aristotle</term> <see><index-term><term>Aristoteles</term> </index-term></see> </index-term>, anche se l’origine avicenniana era tramandata dalle sottoscrizioni di parecchi manoscritti e nota a commentatori come ad esempio Adamo di Bockenfield<index-term index-type="person" id="idx903"> <term vocab-term-identifier="http://xmlns.com/foaf/spec/#term_Person" >Adamo di Bockenfield</term> <see-also><index-term><term>Adam de Bocfeld</term></index-term> </see-also> <see-also><index-term><term>Adam Bockenfield</term></index-term> </see-also> </index-term></p> ...
Example 4
A multi-level index term:
...
<p>Almost from the beginning, the history of Romanesque art and
architecture<index-term index-type="subject"><term>architecture</term>
<index-term index-type="subject"><term>Romanesque (historiography)</term>
</index-term></index-term> was linked to the intercourse and growth
generated by movement along the roads to the shrine of St. James at
Compostela.</p>
...Example 5
A fictitious example, intended to illustrate deeply nested multi-level index term:
...
<p>This is a paragraph with indexing throughout. For example, it
shows primary index terms<index-term><term>primary level index
term</term></index-term>, and then continues with embedded
index terms such as this one.
<index-term><term>primary level index term</term>
<index-term><term>secondary term</term></index-term>
</index-term> as the text continues.</p>
<p>Now that you see how it works, this paragraph is slightly
more realistic. It talks about Poodles, for example, <index-term>
<term>poodle</term></index-term>, and then continues on
with other embedded index terms such as this 2-level one.
<index-term><term>dogs</term>
<index-term><term>poodles</term></index-term>
</index-term> The text continues, if necessary.</p>
<p>Finally, as an illustration, this is a very complex, multilevel
index term
<index-term>
<term>primary term</term>
<index-term>
<term>secondary term</term>
<index-term>
<term>tertiary term</term>
<index-term>
<term>4th level down</term>
<index-term>
<term>5th and out</term>
<see>a lessor, <index-term><term>non-preferred term</term>
</index-term></see>
<see-also>Be advised you might want to look
at this <index-term><term>color-term</term>
</index-term>.</see-also>
</index-term>
</index-term>
</index-term>
</index-term>
</index-term> inside the text of an ordinary paragraph.
Or placed at the end of the paragraph, if that seems
more reasonable.</p>
...