<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

This section is non-normative.

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

Content model

<title>?, <topicmeta>?, ( | <keydef> | <mapref> | <topicgroup>)*, <reltable>*

Not contained by any element.

In order
  1. Optional <title>
  2. Optional <topicmeta>
  3. Zero or more of the following
    • <keydef>
    • <mapref>
    • <topicgroup>
  4. Zero or more <reltable>

Not contained by any element.

Inheritance

- map/map learningGroupMap/learningGroupMap

The <learningGroupMap> element is specialized from <map>. It is defined in the learningGroupMap module.

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