<?xml version="1.0" encoding="utf-8"?>
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->

<!DOCTYPE elementref PUBLIC "-//IBM//DTD DITA Element Reference//EN"
 "elementref_shell.dtd">

<elementref id="map" xml:lang="en-us">
<elementname>
<element>map</element>
</elementname>
<elementdesc>
<purpose>The &lt;<apiname>map</apiname>> element is used to define a map which
describes the relationships among a set of DITA topics. Maps consist of references
to topics organized into hierarchies. Maps provide a way to
express these relationships in a single common format that can be used for
different outputs, such as to aggregate related topics for a single print
job.<p>The containing element for a map is the &lt;<apiname>map</apiname>>
element, which can take title and id attributes. Within the map, use the &lt;<apiname>topicref</apiname>>
element to add and organize references to the topics.</p><indexterm>map</indexterm><indexterm>Map
elements<indexterm>map</indexterm></indexterm></purpose>
<containedby>This is the root element for mapping applications.</containedby>
<contains><xref href="topicref.xml" type="topic">topicref</xref> (0 or more) </contains>
<attributes>
<attlist id="map_attr">
<attribute conref="commonLRdefs.xml#commonLRdefs/title">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>
<attrequired></attrequired>
</attribute>
<attribute conref="commonLRdefs.xml#commonLRdefs/id-map">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>
<attrequired></attrequired>
</attribute>
<attribute conref="commonLRdefs.xml#commonLRdefs/class">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>


<attrequired></attrequired>
</attribute>
</attlist>
</attributes>
<examples>In this example, there are six topicrefs. They are nested and have
a hierarchical relationship. Bats.xml is the parent topic and the other topics
are its children.<codeblock>&lt;map title="Bats" id="mybats"> Bats
 &lt;topicref href="bats.xml" type="topic"
  &lt;topicref href="batcaring.xml" type="task">&lt;/topicref>
  &lt;topicref href="batfeeding.xml" type="task">&lt;/topicref>
  &lt;topicref href="batsonar.xml" type="concept">&lt;/topicref>
  &lt;topicref href="batguano.xml" type="reference">&lt;/topicref>
  &lt;topicref href="bathistory.xml" type="reference">&lt;/topicref>
 &lt;/topicref>
&lt;/map></codeblock></examples></elementdesc>
</elementref>

