3.11.2.1 `<learningGroupMap>`

Use a <learningGroupMap> to create standalone aggregations of <learningObject> and <learningGroup> elements, as well as overviews, summaries, and assessments, according to the needs identified by the learning goals and objectives.

Description and Semantics

The <learningGroupMap> is a map specialization which supports the DITA learning and training map domain. It is used to aggregate <learningObject> and <learningGroup> elements, together with their supporting files and assessments, into a single standalone map type. The <learningGroupMap> references one and only one <learningGroup>. Any <topicref> elements that occur before the <learningGroup> are intended to be resource-only references such as key definitions.

Recursion is provided to support complex aggregations of learning content and can be used as necessary to support the creation of complex learning structures, such as learning units, sections, and courses.

Content models

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

Inheritance

- map/map learningGroupMap/learningGroupMap

Example

<learningGroupMap id="learningGroupMap1">
        <title>Sample learningGroup map</title>
        <learningGroup>
            <learningObject>
                <learningOverviewRef href="learningOverview.dita" scope="local" 
                    type="learningOverview" format="dita"/>
                <learningContentRef href="learningContent.dita" scope="local" 
                    type="learningContent" format="dita"/>
                <learningSummaryRef href="learningSummary.dita" scope="local" 
                    type="learningSummary" format="dita"/>
            </learningObject>
            <learningGroupMapRef href="learningGroupMap2.ditamap" scope="local"
                type="learningGroupMap" format="ditamap"/>
        </learningGroup>   
</learningGroupMap>

Attributes

The following attributes are available on this element: Universal attribute group (with a narrowed definition of @id, given below), Attributes common to many map elements , Architectural attribute group , outputclass, and the attributes defined below. This element also uses @type, @scope, and @format from Link relationship attribute group .

@id: Allows an ID to be specified for the map. Note that maps do not require IDs (unlike topics), and the map ID is not included in references to elements within a map. This attribute is defined with the XML Data Type ID.
@anchorref: Identifies a location within another map document where this map will be anchored. Resolution of the map is deferred until the final step in the delivery of any rendered content. For example, anchorref="map1.ditamap#a1" allows the map with @anchorref to be pulled into the location of the anchor point "a1" inside map1.ditamap when map1.ditamap is rendered for delivery.
@title: An identifying title for the map. May be used or ignored, depending on the capabilities of the display mechanism. Note that beginning with DITA 1.1, the map can include a <title> element, which is preferred over the @title attribute.