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.

Content models

See appendix for information about this element in OASIS document type shells.


+ 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.

Was this helpful?