本系列的第一篇文章 定义了一组 DITA 主题类型和其他扩展,为开发用于创作和交付学习内容的 XML 内容模型提供了一个框架。我们确定了开发和交付学习内容的 DITA 端到端过程模型的主要步骤,其中包括:
- 确定和建模学习的要求和目标
- 将要求组织到课堂和模块中
- 确定支持这些要求的已有主题和开发基于主题的新内容
- 根据需要为实验、练习和测验开发主题内容
- 针对每个目标和整个课程编写概述和总结
- 用映射为特定课程的交付组织主题
- 使用 XSLT 为特定交付品处理映射和主题
本文中,我们描述如何将这种学习 DITA 过程模型应用于一个示范课程,我们使用了现有的 IBM DB2 Query Monitor 课程。该课程最初是为教员指导的培训(ITL)开发的,内容包括教员使用的幻灯片、教员指南(打印的 PDF)和学员指南(打印的 PDF)。
本案例研究使用的示范课程虽然很短(只有 4 个小时),但是很完整,包括实验和练习、学习目标、课堂总结以及教员指导的课堂培训课程常见的其他成分。
Query Monitor 课程现有的打印版学员指南包括以下内容:
- 开场白
- 课程介绍
- 模块 1——使用 Query Monitor
- 模块 2——使用筛选器和配置文件
- 课程小结
- 附录 A——安装 Query Monitor
此例的主要目标是探讨如何将最初作为单一的大型课程构思的内容分解,形成基于主题的内容片段,然后作为可重用的学习对象(RLO)重新组织成自含的课程模块来交付。这样就可以在以后作为电子学习课程交付时定位这些内容。
对 Query Monitor 课程重新加工的过程中,我们采用针对学习调整的 DITA 过程模型,如后所述。
首先,我们为 Query Monitor 课程确定了两个模块级的学习目标:
- 使用 Query Monitor
- 使用筛选器和属性
接下来在每个模块级目标中确定任务、概念和支持课堂级学习目标所需要的参考信息。
- 使用 Query Monitor
- 通过 Query Monitor ISPF 界面导航
- 使用 ISPF 命令
- 使用筛选器和属性
- 使用筛选器细化显示的查询细节层次
- 通过创建监控、应用程序和异常配置文件来定义要监控的任务
- 分析和解释受监控的查询会话结果
原来的课程材料不包含实验练习或测验。我们在总体设计中为这些主题留了地方,并准备在试验的下一阶段开发电子学习交付品时进行测试。
对于两个模块级目标,我们都建立了概述和总结主题,整个课程还有另一组概述和总结主题。更详细的课程应该在课程结构层次的每一级别上都包括概述和总结主题,如课堂、模块、单元级以及整个课程。
学习概述
清单 1 是来自示范课程的示例学习概述主题。该主题包括主要内容、学习目标、时间以及其他概括性的信息。
清单 1. 学习概述主题
<?xml version='1.0' encoding='utf-8'?>
<learningoverbody>
<mainpoints>
<p>At the end of this module, you will be able to:</p><ul>
<li>Navigate through the Query Monitor ISPF interface</li>
<li>Use the various ISPF commands</li></ul>
</mainpoints>
<duration><title>Duration</title><p>2 hours</p></duration>
<objectives>
<title>Objectives</title><ul>
<li>Navigate through the Query Monitor ISPF interface</li>
<li>Use the various ISPF commands</li></ul>
</objectives>
<prerequisites><title>Course prerequisites</title>
<ul><li>Basic SQL and DB2 skills</li></ul>
</prerequisites>
</learningoverbody>
</learningover> |
学习总结
清单 2 是一个学习总结主题。该例中,完整的总结放在内容提要中。
清单 2. 学习总结主题
<?xml version='1.0' encoding='utf-8'?>
<learningsummary id="DB2QM238_SUM">
<title>Summary</title>
<learningsummarybody>
<mainpoints>
<p>You should now be able to:</p>
<ul>
<li>Navigate through the Query Monitor ISPF interface</li>
<li>Use the various ISPF commands</li>
</ul>
</mainpoints>
</learningsummarybody>
</learningsummary> |
在创建学习模块的主题映射时,我们选择希望包含在单元中的主题,然后按照需要的顺序排列主题。我们使用 topichead 元素组织每个学习单元的主题。
清单 3 是示范课程中“模块 2 —— 使用 Query Monitor”的主题映射的一部分。
清单 3. 学习映射
<map title="DB2 Query Monitor Course">
<topichead navtitle="Module 2: Using the Query Monitor">
<topicref href="querymonitor_over.xml"/>
<topicref href="ispf_nav_ref.xml"/>
<topicref href="main_panel_ref.xml"/>
<topicref href="qm_discovery_task.xml"/>
. . .
<topicref href="planview_concept.xml"/>
<topicref href="dbrmview_concept.xml"/>
<topicref href="activate_task.xml"/>
<topicref href="deactivate_task.xml"/>
<topicref href="DB2QM238_Summary.xml"/>
<topicref href="DB2QMLAB201_practice.xml"/>
</topichead>
</map> |
下面列出了映射中的主题,显示了嵌套的主题类型及标题:
- 概述:使用 Query Monitor
- 参考:ISPF 导航
- 参考:主面板
- 任务: DB2 QM Subsystem Discovery
- . . .
- 概念:视图操作总结:计划
- 概念:视图操作总结:DBRM/Package
- 任务:激活 Monitoring Agent
- 任务:取消 Monitoring Agent
- 总结:总结
- 练习:练习 1 —— 导航 Query Monitor Interface
我们使用 XSLT、Ant 和 DITA Open Toolkit(请参阅 参考资料)提供的 FO 处理将映射和主题转化成 ILT 课程使用的 PDF 交付品。图 1 显示了一个输出的例子。
图 1. Main Panel 主题的 PDF 输出
在最初的项目设计阶段和试验性实现阶段中,我们遇到了与转向基于主题的、信息类型化内容开发有关的一些挑战。
首先,按照过去开发新课程的经验,我们往往强调在内容开发中采用讲故事的叙述性方法,信息很容易衔接。采用这种方法,课程开发人员很少考虑将内容分成不同的类型。比方说,概念性的信息常常与支持概念所需要的参考信息和任务信息混杂在一起。
重新将试验内容加工成基于主题的 DITA,这一过程中我们面临的主要挑战是改变思维惯性,将内容看成是离散的信息块,而不再是单一的、长长的叙述流。
其次,除了学习如何将内容分解成基于主题的单元外,我们还需要运用为内容分配具体主题类型的基本原则。这要求我们将原来的混合段落,甚至有可能是整页信息,分成离散的、包含单一信息类型的主题,如概念、任务或参考资料类型。
我们发现必须遵守的主要规则是:每段信息必须完全是关于一种内容类型的。它必须传达关于那段特定信息的知识,不能与其他主题块中的信息直接重叠。
最后,我们面临着这样的困境,将信息分解成单个类型之后,可能会丢失内容在整个学习上下文中的角色。这种情况下,可能首先表现为难以根据这些规则将信息分解成主题和类型;求助于过去的陈述性方法,为保持原来思想的完整性而让内容继续纠缠在一起是很诱人的。
通过这种挑战,要学习的不仅是把内容归结为上述的主题类型(概念、任务或参考),还要考虑整个学习目标的上下文。关键是了解每个主题在学习目标中的位置,DITA 映射中定义的基本上下文提供了学习目标。单个 DITA 主题自身并没有固有的上下文,而是根据在映射中的角色获得上下文。
从根本上说,使用主题和信息类型创作和交付内容是一项技巧,需要时间和经验来学习如何应用到内容中。
该试验项目为使用 DITA XML 支持学习内容开发和交付的最佳实践提供了基本的参照。我们仅仅是刚刚起步,还需要围绕着更丰富、变化更多的学习内容进行更深入的研究,进一步验证、细化和扩展这里列出的设计和过程框架。
具体而言,我们准备从以下方面进一步探索:
- 更多关注在团队内部、团队之间以及跨职能部门之间特定教育内容的重用和重定位。
- 将更健壮的课程转化成 DITA。
- 开发针对教员指导培训所需学习交付品的目标输出转换:
- 学员指南
- 教员指南
- 投影幻灯片
- 扩展 DITA 映射特化以包括课程级和单元级的映射。
- 开发映射过程以支持交付 SCORM 兼容的产品和内容包。
- 根据实际课程内容中要求的具体内容继续细化学习主题类型。注意深化理解电子学习和 SCORM 所需测验和练习主题类型在内容设计、交付品和过程方面的要求。
我们邀请您参与到这些计划中来,建议您通过参加讨论来参与,或者通过 DITA OASIS Technical Committee 的活动来帮助扩展 DITA 标准。
感谢 IBM 的同事 Eric Sirois 和 Don Day,他们帮助准备了可下载的方案和示例主题。
| 描述 | 名字 | 大小 | 下载方法 |
|---|---|---|---|
| Sample DITA topics for this article | x-dita9b-learning.zip | 660 KB | HTTP |
学习
- 您可以参阅本文在 developerWorks 全球站点上的 英文原文。
- 阅读本系列的第一篇文章“基于 XML 的学习内容信息体系结构,第 1 部分”(developerWorks,2005 年 8 月)
- 通过以下 developerWorks 文章进一步了解 DITA:
- “介绍 Darwin 信息分类体系结构——面向可移植的技术信息”(2003 年 10 月)
- “在 Darwin 信息分类体系结构中的专门化——准备基于主题的 DITA文档”(2003 年 10 月)
- “关于 DITA 常见问题——关于文档的基于 XML 的 Darwin信息分类体系结构 (DITA) 的答案”(2004 年 12 月)
- “DITA 中对域进行专门化”(2003 年 10 月)
- “为何用 DITA 生成 HTML 交付品?”(2003 年 10 月)
- “用 DITA 映射领域设计信息体系结构模式”(2004 年 9 月)
- “从 HTML 迁移到 DITA”——从 HTML 转到 DITA 的简单步骤(2005 年 1 月)和 第 2 部分: 扩展迁移工具得到更加理想的结果(2005 年 2 月)
- 在 OASIS 主页 可以找到关于 DITA 的其他信息。
- 如果希望进一步了解 DB2 产品家族,请访问 developerWorks 上的“DB2 新手入门”页面。
- 了解学习对象和 SCORM 的更多背景知识:
- Cisco Systems Reusable Information Object Strategy (Cisco Systems, 1999)
- “Reusable Learning Objects- What does the future hold?”(Peder Jacobsen,LTI Newsline, 2001)
- The Sharable Content Object Reference Model (SCORM) (Advanced Distributed Learning, 2005)
- 加入 OASIS Darwin Information Typing Architecture (DITA) Technical Committee。
- 在 developerWorks XML 专区 可以找到数以百计的 XML 参考资料。
- 了解如何才能成为一名 IBM 认证的 XML 及相关技术的开发人员。
获得产品和技术

