3.11.3.1 <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


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