<learningContentRef>
Use a <learningContentRef> element to include a topic reference
to a learning content topic as part of a DITA <learningObject>
element.
By default, a <learningContentRef> is expected to link to a
<learningContent> topic. However, a
<learningContentRef> can link to content of any type that you want
to use as a learning content in a learning object. In this way, you can structure any
existing DITA content as a learning object, and then take advantage of the learning-specific
processing available for building and packaging that content for delivery in a learning
system or learning context.
The presentation intent for <learningContent> is that the topic be
presented as an atomic unit of presentation, for example, as required by SCORM delivery
requirements. Thus the default value for the @chunk attribute is
"to-content". You can use <learningContentComponentRef> elements to
include subordinate topics.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
+ map/topicref learningmap-d/learningContentRef
Example
See learningObject.
Attributes
The following attributes are available on this element: Universal attribute group, Link relationship attribute group (with narrowed definitions of @href and
@format, given below), Attributes common to many map elements (without the @collection-type attribute,
and with a narrowed definition of @chunk,
given below), 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@formatattribute to identify the kind of resource being referenced. @format- On this element, the
@formatattribute has a default value of "dita", because it usually links to DITA learning topics. If linking to something other than DITA, set the@formatattribute as described in The format attribute. @chunk- On this element, the
@chunkattribute has a default value of "to-content", which causes the current branch of content to be published as a single unit. See Chunking for more information and for details on other supported values.