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.
See appendix for information about this element in OASIS document type shells.
- 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
anchorref="map1.ditamap#a1"allows the map with @anchorref to be pulled into the location of the anchor point "a1" inside
map1.ditamapis rendered for delivery.