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
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.
Parent topic