Home
Language reference: All-inclusive edition
The language reference portion of the DITA specification contains a topic for each DITA element. The topic defines the element, its inheritance hierarchy, and provides examples of usage. This portion of the DITA specification also includes information about DITA attributes.
Learning and training elements
Elements in the learning and training section include specialized topics, maps, content, and metadata elements specially designed to support instructional content.
Learning and training: interactions domain elements
Use the learning interactions to construct a basic set of question and response interaction. The domain also provides an <lcInstructornote2> element, which you can use to provide instructor-specific information in the learning topics.
Interactions domain content elements
Learning and training interactions content elements are used to structure content within learning interactions.
<lcHotspotMap2>
A <lcHotspotMap2> interaction lets you designate an action area or region over an image, allowing a click in that region to get scored as correct or incorrect in response to an interaction question. This element replaces the <lcHotspotMap> element in DITA 1.2.

Specification URIs
Notices
Introduction to DITA 1.3
The Darwin Information Typing Architecture (DITA) specification defines a set of document types for authoring and organizing topic-oriented information, as well as a set of mechanisms for combining, extending, and constraining document types.
Architectural specification: All-inclusive edition
The architectural specification portion of the DITA specification outlines the framework of DITA. It contains an overview of DITA markup; addressing; processing; configuration, specialization, generalization, and constraints; as well as information about coding DITA grammar files.
Language reference: All-inclusive edition
The language reference portion of the DITA specification contains a topic for each DITA element. The topic defines the element, its inheritance hierarchy, and provides examples of usage. This portion of the DITA specification also includes information about DITA attributes.
- Element quick reference
  This section contains a listing of DITA elements.
- Topic elements
  The base topic elements include elements that make up the core building blocks of the DITA topic, such as topic, body, and related-links, as well as elements like <p> and <ph> that are used in many topic specializations. Some of these elements are also available inside the <topicmeta> map element.
- Map elements
  Map elements include the core components of DITA maps, such as <topicref> and <reltable>, as well as general purpose map specializations in the map group domain.
- Metadata elements
  Metadata elements include information that is located within the <topicmeta> element (in maps) or <prolog> element (in topics), as well as indexing elements that can be placed in additional locations within topic content.
- Domain elements
  General purpose domains are not specific to any type of information, such as the hazard statement domain that provides elements for describing hazardous situations.
- Classification elements
  Classification elements support managing metadata. Those in the subject scheme map are used to define controlled values and to bind the controlled values to DITA attributes as enumerations. Those declared in the classification domain are used in other maps to classify content according to the scheme.
- Specialization elements
  Several DITA elements exist either for architectural reasons or for support of specialized markup yet to be designed. Although there is little need to use these elements unless you are directed to, some of them, such as <state>, can be used if your content makes use of these semantic distinctions. For example, a discussion of signals on a gate of an integrated logic circuit might use the <state> element to represent either on or off conditions of that gate.
- Legacy conversion elements
  Conversion elements exist primarily to aid in the conversion of content to DITA.
- DITAVAL elements
  A conditional processing profile (DITAVAL file) is used to identify which values are to be used for conditional processing during a particular output, build, or some other purpose. The profile should have an extension of .ditaval.
- Technical content elements
  Elements in the technical content section include the original Concept, Task, and Reference specializations, as well as specializations added in later releases. It also includes domains designed primarily for technical content.
- Learning and training elements
  Elements in the learning and training section include specialized topics, maps, content, and metadata elements specially designed to support instructional content.
  - Learning and training: topic elements
    Use the learning and training topic types to provide the instructional content, according to the needs identified by the learning goals and objectives.
  - Learning and training: map types
    Use the learning and training map types to aggregate learning content into individual learning objects, groups of learning objects, or higher-level aggregations of learning groups and objects, according to the needs identified by the learning goals and objectives.
  - Learning and training: map domain elements
    Use the learning and training map domain to organize groups of topics as learning objects. Defined as a map domain, these elements are available for use within any DITA map, not just a learning-specific DITA map. For example, you could include learning objects in a DITA generic map or in a DITA bookmap.
  - Learning and training: interactions domain elements
    Use the learning interactions to construct a basic set of question and response interaction. The domain also provides an <lcInstructornote2> element, which you can use to provide instructor-specific information in the learning topics.
    - Top level interactions elements
      Top level interactions elements provide the primary question types available in the learning interactions domains.
    - Interactions domain content elements
      Learning and training interactions content elements are used to structure content within learning interactions.
      - <lcAnswerContent2>
        The <lcAnswerContent2> element in a learning assessment interaction provides the content for an answer option, which the learner can select as correct or incorrect. This element replaces the <lcAnswerContent> element in DITA 1.2.
      - <lcAnswerOption2>
        The <lcAnswerOption2> element in an assessment interaction provides the content and feedback for a question option, and can indicate the correct option. This element replaces the <lcAnswerOption> element in DITA 1.2.
      - <lcAnswerOptionGroup2>
        The <lcAnswerOptionGroup2> element provides a container for the options for a true-false, single-select, or multiple-select assessment interaction. This element replaces the <lcAnswerOptionGroup> element in DITA 1.2.
      - <lcArea2>
        A <lcArea2> defines an area of a hotspot image that contains a correct or incorrect choice in a hotspot assessment interaction. This element replaces the <lcArea> element in DITA 1.2.
      - <lcAreaCoords2>
        The <lcAreaCoords2> element specifies the coordinates of a linkable hotspot in a learning image. This element replaces the <lcAreaCoords> element in DITA 1.2.
      - <lcAreaShape2>
        The <lcAreaShape2> element defines the shape of a linkable hotspot in a learning image. This element replaces the <lcAreaShape> element in DITA 1.2.
      - <lcAsset2>
        The <lcAsset2> element in an assessment interaction provides the images or other graphic assets to support the interaction. This element replaces the <lcAsset> element in DITA 1.2.
      - <lcCorrectResponse2>
        The <lcCorrectResponse2> element in an assessment interaction indicates a correct response. This element replaces the <lcCorrectResponse> element in DITA 1.2.
      - <lcFeedback2>
        The <lcFeedback2> element in an assessment interaction provides information to the learner about a correct or incorrect response. This element replaces the <lcFeedback> element in DITA 1.2.
      - <lcFeedbackCorrect2>
        The <lcFeedbackCorrect2> element in an assessment interaction provides feedback to the learner about a correct response. This element replaces the <lcFeedbackCorrect> element in DITA 1.2.
      - <lcFeedbackIncorrect2>
        The <lcFeedbackIncorrect2> element in an assessment interaction provides feedback about incorrect response. This element replaces the <lcFeedbackIncorrect> element in DITA 1.2.
      - <lcHotspotMap2>
        A <lcHotspotMap2> interaction lets you designate an action area or region over an image, allowing a click in that region to get scored as correct or incorrect in response to an interaction question. This element replaces the <lcHotspotMap> element in DITA 1.2.
      - <lcInteractionLabel2>
        Use <lcInteractionLabel2> to provide a label or title for an interaction.
      - <lcItem2>
        The <lcItem2> element in an assessment interaction provides the content for an item that matches the match item in a match table. This element replaces the <lcItem> element in DITA 1.2.
      - <lcMatchingHeader2>
        The <lcMatchingHeader2> element in an assessment interaction provides column headings for items to present in a matching table. This element replaces the <lcMatchingHeader> element in DITA 1.2.
      - <lcMatchingItem2>
        The <lcMatchingItem2> element in an assessment interaction provides the content for the matching side of a matching pair of items in a match table interaction. This element replaces the <lcMatchingItem> element in DITA 1.2.
      - <lcMatchingItemFeedback2>
        The <lcMatchingItemFeedback2> element in an assessment interaction provides feedback on the match as a whole or on correct and incorrect matches or both. This element replaces the <lcMatchingItemFeedback> element in DITA 1.2.
      - <lcMatchingPair2>
        The <lcMatchingPair2> element in an assessment interaction provides a table row with the pair of items that comprise a correct match in a matching interaction and, optionally, feedback on the pair or correct and incorrect matches. This element replaces the <lcMatchingPair> element in DITA 1.2.
      - <lcMatchTable2>
        The <lcMatchTable2> element in an assessment interaction provides a format for matching items. This element replaces the <lcMatchTable> element in DITA 1.2.
      - <lcOpenAnswer2>
        Use <lcOpenAnswer2> to provide a suggested answer for an <lcOpenQuestion2> interaction. This element replaces the <lcOpenAnswer> element in DITA 1.2.
      - <lcQuestion2>
        Use the <lcQuestion2> element in an interaction to ask the question. This element replaces the <lcQuestion> element in DITA 1.2.
      - <lcSequence2>
        The <lcSequence2> element in an assessment interaction provides the position of a sequence option in a sequence. This element replaces the <lcSequence> element in DITA 1.2.
      - <lcSequenceOption2>
        The <lcSequenceOption2> element in an assessment interaction provides the contents of an item in a sequence interaction. This element replaces the <lcSequenceOption> element in DITA 1.2.
      - <lcSequenceOptionGroup2>
        The <lcSequenceOptionGroup2> element provides the options for an assessment sequence interaction. This element replaces the <lcSequenceOptionGroup> element in DITA 1.2.
  - Learning and training: interactions domain elements (DEPRECATED)
    Use the learning interactions to construct a basic set of question and response interaction. The domain also provides an <lcInstructornote> element, which you can use to provide instructor-specific information in the learning topics.
  - Learning and training: metadata elements
    Use the learning and training metadata to describe specific characteristics of the learning content. The learning and training metadata elements provide a robust metadata model for learning objects, built upon industry standards and best practices. Defined as a domain, these elements are available for use in both the topic <prolog> and the map <topicmeta>.
  - Learning and training: common content elements
    The learning and training content elements provide specialized content for learning topics.
- Attributes
  This section collects commonly used attributes, with common definitions. If an element uses a different definition, or narrows the scope of, an otherwise common attribute, it will be called out in the topic that defines the element.
Conformance
Conformance to the DITA specification allows documents and document types that are used with different processors or different versions of a processor to produce the same or similar results with little or no reimplementation or modification.
Acknowledgments
(Non-normative) Many members of the OASIS DITA Technical Committee participated in the creation of this specification and are gratefully acknowledged.
Non-normative information
This section contains non-normative information, including topics about new features in DITA 1.3 and migrating from DITA 1.2 to DITA 1.3.
Content models for learning and training package
For each element in the learning and training package, this section presents the content model and a list of parent elements that can contain that element.

`<lcHotspotMap2>`

A <lcHotspotMap2> interaction lets you designate an action area or region over an image, allowing a click in that region to get scored as correct or incorrect in response to an interaction question. This element replaces the <lcHotspotMap> element in DITA 1.2.

Content models

See appendix for information about this element in OASIS document type shells.

Inheritance

+ topic/fig learningInteractionBase2-d/figgroup learning2-d/lcHotspotMap2

Example

   <!--Hotspot Interaction    -->
   <lcHotspot2>
    <lcInteractionLabel2>Team logos hotspot</lcInteractionLabel2>
    <lcQuestion2>Which of the following is the logo for the Minnesota Twins?</lcQuestion2>
    <lcHotspotMap2>
     <image href="hotlogos.gif"/>
     <lcArea2 id="twins">
      <lcAreaShape2>rect</lcAreaShape2>
      <lcAreaCoords2>0,0,50,50</lcAreaCoords2>
      <lcCorrectResponse2 value="twins"/>
      <lcFeedback2>Yes.</lcFeedback2>
     </lcArea2>
     <lcArea2 id="giants">
      <lcAreaShape2>rect</lcAreaShape2>
      <lcAreaCoords2>50,0,100,50</lcAreaCoords2>
      <lcFeedback2>No.</lcFeedback2>
     </lcArea2>
     <lcArea2 id="cardinals">
      <lcAreaShape2>rect</lcAreaShape2>
      <lcAreaCoords2>0,50,50,100</lcAreaCoords2>
      <lcFeedback2>No.</lcFeedback2>
     </lcArea2>
     <lcArea2 id="orioles">
      <lcAreaShape2>rect</lcAreaShape2>
      <lcAreaCoords2>50,50,100,100</lcAreaCoords2>
      <lcFeedback2>No.</lcFeedback2>
     </lcArea2>
    </lcHotspotMap2>
   </lcHotspot2>

Attributes

The following attributes are available on this element: Universal attribute group and outputclass.