Use a <learningGroupMapRef> element to include a map reference to a learning group map as part of a DITA learning map, learning bookmap, learning group map, or <learningGroup> element.

Description and Semantics

The <learningGroupMapRef> is a <topicref> specialization included in the DITA learning and training map domain. It is used to reference a single learning group map, 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/learningGroupMapRef


<map id="map_1234">
    <title>Learning map with learningGroup map references</title>
    <!-- .... -->
    <!-- As child of map -->
    <learningGroupMapRef href="learningGroupMap1.ditamap" type="learningGroupMap" 
        format="ditamap" scope="local"/>
    <!-- .... -->
    <learningGroup navtitle="Top-Level Learning Group">
        <!-- .... -->
        <!-- As component of learningGroup -->
        <learningGroupMapRef href="learningGroupMap2.ditamap" type="learningGroupMap" 
            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 .