learningGroupMapRef

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

version
1.3
author
OASIS DITA Technical Committee

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.

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.