DITA 1.3 Language Reference : Language reference: All-inclusive edition : Learning and training elements : Learning and training: map domain elements : learningGroup
Was this helpful?
learningGroup
Use a learningGroup to structure learning objects into higher-level organizations, such as course-level, module-level, or lesson-level.
In addition to organizing learningObject elements, a learningGroup can include topic references to learningPlan, learningOverview. and learningSummary topics, and can also include references to learningAssessment topics. A learningGroup can also contain other learningGroup elements, allowing you to organize learning content at course, module, or other higher levels of hierarchy.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
+ map/topicref learningmap-d/learningGroup
Example 499. Example

<map id="learningGroup_example">
<!-- a learningGroup can appear anywhere in a map hierarchy but always
follows a consistent information pattern -->
<!-- ************************************************************* -->
<!-- a course=level learning group -->
<learningGroup href="course_top_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningPlanRef href="course_Plan_topic.dita" type="learningPlan" />
<learningOverviewRef href="course_Overview.dita" type="learningOverview"/>
<!-- ************************************************************* -->
<!-- module-level learning groups -->
<learningGroup href="module1_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="module1_Overview.dita" type="learningOverview"/>
<!-- ************************************************************* -->
<!-- This module has two lesson-level groups of learning objects -->
<learningGroup href="lesson1_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="lesson1_Overview.dita" type="learningOverview"/>
<!-- learning objects in lesson1 -->
<learningObject collection-type="sequence" href="lo1_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningObject collection-type="sequence" href="lo2_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningAssessmentRef href="lesson1_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="lesson1_Summary.dita" type="learningSummary"/>
</learningGroup>
<!-- ************************************************************* -->
<learningGroup href="lesson2_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="lesson1_Overview.dita" type="learningOverview"/>
<!-- learning objects in lesson2 -->
<learningObject collection-type="sequence" href="lo3_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningObject collection-type="sequence" href="lo4_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningAssessmentRef href="lesson2_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="lesson2_Summary.dita" type="learningSummary"/>
</learningGroup>
</learningGroup>
<!-- ************************************************************* -->
<learningGroup href="module2_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="module1_Overview.dita" type="learningOverview"/>
<!-- learning objects in module 2 (no lesson-level groups) -->
<learningObject collection-type="sequence" href="loA_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningObject collection-type="sequence" href="loB_Overview.dita" type="learningOverview">
</learningObject>
<!-- . . . -->
<learningObject collection-type="sequence" href="loC_Overview.dita" type="learningOverview">
</learningObject>
<learningAssessmentRef href="module2_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="module2_Summary.dita" type="learningSummary"/>
</learningGroup>
<!-- ************************************************************* -->
<learningAssessmentRef href="course_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="course_Summary.dita" type="learningSummary"/>
</learningGroup>
<!-- ************************************************************* -->
</map>
Attributes
The following attributes are available on this element: Universal attribute group, Link relationship attribute group (with a narrowed definition of href, 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.