Darwin Information Typing Architecture (DITA) Version 1.3 Part 3: All-Inclusive Edition

OASIS DITA Technical Committee

Use a learningObjectMapRef element to include a map reference to a learning object map as part of a DITA learning map, learning bookmap, or learning group map.

Description and Semantics

The learningObjectMapRef is a topicref specialization included in the DITA learning and training map domain. It is used to reference a single learningObjectMap, either from a learning map, learning bookmap, learning group map or learningGroup element.


+ map/topicref learningmap-d/learningObjectMapRef


<map id="map_1234">
    <title>Learning map with learningObject map references</title>
    <!-- .... -->
    <!-- As child of map -->
    <learningObjectMapRef href="learningObjectMap1.ditamap" type="learningObjectMap" 
        format="ditamap" scope="local"/>
    <!-- .... -->
    <learningGroup navtitle="Top-Level Learning Group">
        <!-- .... -->
        <!-- As component of learningGroup -->
        <learningObjectMapRef href="learningObjectMap2.ditamap" type="learningObjectMap" 
            format="ditamap" scope="local"/>
        <!-- .... -->


The following attributes are available on this element: Universal attribute group, Link relationship attribute group (with narrowed definitions of href and format, given below), Attributes common to many map elements, Topicref element attributes group, outputclass, keys, and keyref.

A pointer to the resource represented by the topicref. See The href attribute for detailed information on supported values and processing implications. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the format attribute to identify the kind of resource being referenced.
On this element the format attribute sets a default value of "ditamap", because the purpose of the element is to reference a ditamap document. Otherwise, the attribute is the same as described in Link relationship attribute group.