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.
- map/map learningGroupMap/learningGroupMap
<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>
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.
- 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.
- 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.
- 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.