learningGroup

Darwin Information Typing Architecture (DITA) Version 1.3 Part 3: All-Inclusive Edition

version
1.3
author
OASIS DITA Technical Committee

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.

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.