<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.
See appendix for information about this element in OASIS document type shells.
+ map/topicref learningmap-d/learningGroup
<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>
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
<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.