<mapresources>

Map resources are objects with a @processing-role set to resource-only, for example, key definitions and subject scheme maps. Such resources do not contribute to the navigation structure, although they might be essential for authoring and processing.

Specialization hierarchy

The <mapresources> element is specialized from <topicref>. It is defined in the mapgroup-domain module.

Attributes

The following attributes are available on this element: common map attributes (excluding @chunk and @collection-type), link-relationship attributes, universal attributes, @impose-role, @keyref, and @keys.

For this element, the @processing-role attribute has a default value of resource-only.

Examples

This section provides examples of how the <mapresources> element can be used.

Figure 1. Specifying resource-only objects in an intuitive location in a book map

The following code sample illustrate how the <mapresources> element can group references to key definitions, subject schemes, and other resources in a bookmap:

<bookmap>
  <booktitle>
    <mainbooktitle>Test bookmap</mainbooktitle>
  </booktitle>
  <mapresources>
    <mapref href="key-definitions.ditamap"/>
    <mapref href="subject-scheme.ditamap" type="subjectscheme"/>
    <topicref href="cover-page.dita outputclass="cover-page"/>
  </mapresources>
  <!-- ... -->
</bookmap>

Note that this example illustrates that <mapresources> can be used to make topics available for resource-only processing. In this scenario, the company uses a processor that uses content contained in the cover-page.dita file to generate a PDF cover page.

Figure 2. Specifying resource-only objects in a map

The following code sample shows a map that contains information for a specific model of a controller. This map is referenced in an omnibus publication that contains information for an entire family of controllers.

<map keyscope="model-XNP09">
  <title>Model XNP09</title>
  <mapresources>
    <keydef keys="model-illustration" href="model-XNP09.png" format="png"/>
    <keydef keys="remove-cover" href="remove-cover-XNP09.png" format="png"/>
  </mapresources>
  <topicref href="model-overview.dita/>
  <topicref href="installing.dita"/>
  <topicref href="uninstalling.dita/>
  ...
</map>