DITA Resource Center

<learningGroupMapRef>

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.

Inheritance

+ map/topicref learningmap-d/learningGroupMapRef

Example

<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"/>
        <!-- .... -->
    </learningGroup>    
</map>

Attributes

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.

@href
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.
@format
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 page helpful?