|
关于DITA常见问题广告 关于DITA常见问题
Michael Priestley Gretchen Hargis IBM 公司 2001 年 3 月 常规 DITA 问题 常规 DITA 问题 问：为什么这个体系结构以 "Darwin" 命名？ 答：该体系结构的完整名称有这个组合解释： Darwin: 它使用专门化和继承的原理
问：我在哪里可以了解更多有关面向主题的编写和用户辅助？ 答: 浏览下面的主题体系结构 FAQ，然后尝试下面两个关于信息体系结构的介绍性站点。 答: 尽管 DocBook 和 DITA 都着重于交付技术信息，但 DocBook 的解决方案主要侧重于交付书籍，而 DITA 则着重于交付主题，它可以组装到书中，也可以一起链接至帮助集或网站。DITA 的主要延展机制 -- 专门化 -- 是基于主题级的信息分类，而不是文档分类。专门化允许作者描述特定信息域而不影响常规过程或增加核心 DTD 复杂性。主题类型、主题内容和基于主题的转换都设计成通过引用来重用。因此，重用的控制移到重用者而不影响访问公共过程或工具，也不需要损害信息的可移植性、使用期限或一致性。 问：如何进行和控制对 DTD 的修改？ 答: DITA 设计是一个原型；该设计 — 包括 DTD 和样式表 — 将通过感兴趣的用户社区 — 您的反馈来不断地发展。 使用 DITA 论坛来讨论 DITA DTD 和样式表的使用。在 read-me 文档列出了几个已知的局限性，但当您在使用 DTD 时，无疑其他人也在期待的发现。通过 DITA 论坛中的讨论，我们将一些重要的想法应用至后续的刷新软件包。DITA 项目的体系结构设计师 Don Day 和 Michael Priestley 以及其他人将积极监控论坛。 在我们知道将更改或应该考虑的事项有是： XLink 库的使用 问：我可以在我的公司内使用 DTD 吗？ 答：可以，我们鼓励您使用它。 问：DITA 已集成到任何 IBM 的产品中吗？ 答: 是的。我们正在进行的几个项目就是使用 DITA。这些项目的目的就是继续确认 DITA 体系结构和在产品开发环境中使用 DTD。 问:有 DITA DTD 的 XML 模式吗? 答: 还没有。文档若要跨系统使用以及有很长生命周期，就应该用已有的最标准格式定义，现在仍然是 DTD。 尽管 XML 模式可以提供 DTD 所不能提供的内容规则 ，但许多文档创作工具和生产工具仍然依赖于 DTD。如果您整个进程所有的工具都支持模式，对文档使用 XML 模式就有意义。如果您开发和生产文档的过程既可以使用支持 DTD 又可使用支持模式工具，那么目前最好依靠 DTD。除非您创建一个模式可以仅仅允许 DTD 所允许的，您就不能在模式和 DTD 驱动的创作系统中之间切换了。实际上，如果我们所依靠的工具在可以忽略 DTD 时，使用模式只有很少实际优势。 XML 模式的优点之一是它可以作为信息模型式的正式规范语言来使用。而现在，我们将继续使用 DTD 格式作为我们模型的记录定义，我们 将依赖于今后的工具来将 DTD 转换成即将出现的 W3C XML 模式标准。 我们设计 DITA 时，在预料到模式语言后的专门化原理，并且我们计划转到模式表示法上。 DITA 的主题体系结构 问: 什么是主题？ 答: 主题是按单一题目范围组织的一段信息。从结构上看，它是一个后面跟随着文本和图象的主题，可选地按节组织成。主题有许多不同类型，最通用的是概念、任务和引用。 问: 为什么使用主题？ 答: DITA 是基于主题的，因为主题是允许以不同交付上下文重用而不影响作者效率的最理想尺寸。如果我们选择小一些的单元，作者需要核对所有上下文的单元，以确保信息流正确。如果我们选择大一些的单元，信息不容易重新合并到不同交付上下文所需的结构。从作者的观点来说，一个主题要大到能自我容纳，但要小到特殊上下文需要的以任何高级结构的有效重用。 问: 什么是在体系结构中主题结构？ 答: 主题结构是我们为文档体系结构建立的某些条件的结果。 <topic> 是单一非嵌套主体和任何数量的嵌套主题的容器。 <!ELEMENT topic (title,prolog?,body,%info-types,*> 参阅样本主题，及其说明，DITA 主题的结构. 问: 什么是主题中的渐进公开？ 答：因为每一主题除了正文以外都有一个标题和简短描述，应用程序可以提供渐进公开。例如，用户可以在链接上看一下它的简短描述然后再决定是否按链接查看完余下的主题。渐进公开也允许有针对性的以不同查看环境浏览主题，无论是全屏幕浏览，还是集成帮助窗格，弹出信息或 PDA 屏幕。应用程序可以尽可能多的公开环境所支持的内容，以便用户决定从哪里和如何发掘更多内容。 问：可以嵌套主题吗？ 答：可以嵌套主题以创建更大的文档结构。但是，嵌套总是发生在内容边界，以便可以很方便地子与父主题按不同的上下文中分离或重用（参阅 DITA 主题结构 ）。这里有个嵌套结构的示例。 <topic> 可以用嵌套结构或个别独立文档来创作主题。在后一种情形中，根据需要将文档组装成嵌套结构，比如说当交付有部分和章节层次的印刷或可打印的信息。 嵌套的结构在主题集合中给出一个主题序列和层次结构。在 Web 环境中，可以将此结构反汇编成个别主题，并在生成的导航映射或目录表中保留其层次结构。但是，如果 Web 是主要的交付工具，可能希望将主题作为单独的文档来创作，然后应用在相同主题集合的几个目录表中。 问：什么是信息类型？ 答：信息类型描述主题的类别，例如概念、任务或引用。正常情况下，不同信息类型支持不同种类的内容。例如，通常任务有一组步骤，而引用主题有一组定制部分，象语法、特性和用法。 问：为什么使用信息类型？ 答：使用信息类型可以将主题分成类别，这比在没有信息类型时，可以更加容易的管理和保持一致性。信息类型也可以帮助用户更加容易查找到他们所要查找的信息：任务中的 how-to 信息对比概念中的背景信息对比引用主题中详细的规范。 问：什么是专门化？ 答：专门化是创建主题新类别或信息类型的过程。可以使用现有的作为基础来定义这些新类型。例如，产品组可能将引用主题标识为三个主要类型：信息、实用程序和 API。通过对内容的每一类创建专门的主题类型，产品的体系结构可以确保每一主题类型都有适当的内容。另外，专门化主题使支持 XML 搜索更加有效，因为用户可以利用精细特征。例如用户可以仅在信息或仅在 API 中搜索 xyz，以及通常跨引用主题搜索 xyz。 规则可以监管如何安全地专门化：每一新信息类型必须映射到现有的一种类型，而且新信息类型必须比它们所允许的内容中现成的更加有限制性。使用这样的专门化，新信息类型可以使用翻译、打印和 Web 发布的类属处理流。虽然产品组可以覆盖或扩展这些过程，在不需要额外工作或维护下，他们可以缺省地获得全系列现有过程。DITA 专门化文章的附录描绘了这些规则。 技巧和技术 问：我如何将几个主题合并成单一文档？ 答：DITA 基本语言提供了有 W3C XInclude 建议 语义意图的 <include> 元素。这个元素在主题或其他信息类型有效的位置都是有效的。例如，这里是一个简单的父文档，它在用 DITA 样式表处理后，在一个公共输出中合并了其他两个支持： <topic> 查看或处理父文档导致子主题包含在复合结果。 问：如果我的信息没有分成主题，该怎么办？ 答：大多数信息都可以分成主题（标题和内容）。但是，如果您的信息需要更加无缝的跨主题边界的信息流动，不要使用这个体系结构。 问：什么时候应该专门化？ 答：当您有一个希望保持一致性限制性的类别主题，或者您的用户希望有与众不同的类别时，可以创建专门化主题。确保从正确基本类型专门化：例如，引用主题的类别应该专门化
<reftopic>，任务的类别应该专门化 <task>。如果您需要比基本类型允许还要多的内容结构，可以直接从 topic
专门化或形成您自己的基类型。但是，在您专门化的层次结构中，层次结构越低越好；然后可以利用任何转换和处理，这些转换和过程是为更常规的类别（您从其专门化）而开发的。 答：需要标识出信息的新类型与从您专门化的更常规类型的差异。在已经标识出差异之后，创建一个 DTD 文件以宣布您所需求的新元素。创建另外一个模块，声明新元素的一组映射属性指向它们专门化的类属元素类型。然后在 DTD 文档中添加导入语句以引入映射模块和任何父模块。最后，添加一行重新定义信息类型实体以包含新类型。现在，您有了一个定制的 DTD。 使用这个通用过程创建一个专门化的信息类型： 标识需要的元素。 问：如何扩展支持专门化的转换？ 答：通过使用这个常规过程创建专门化 XSL 转换： 创建用于您的信息类型的新转换。 答：可以。许多作者都至少有一些使用 HTML 标记语言的经验。因此，对于可能使用的主题的技术信息类型，基本 DITA DTD 合并了许多有用的 HTML 元素。另外我们已经定义了一个 XHTML 的子集，可以很方便地转换成 DITA 格式 -- 对于许多内容元素通常没有变化！事实上，如果您可以将一个 XHTML 文档加载到和 XML DITA 文档一样的编辑器，您也许可以直接将一长段 XHTML 内容拷贝和粘贴至主题。无论如何，为了获得 XML 的真正好处，您应该使用 DTD 的语义。 问：我在哪里可以看到使用中的 DITA DTD？ 答：就在这里！这个 FAQ 就是以 XML 格式，使用了 DTD 的 qalist 部分。借助于样式表，使您在浏览器中能看到。和本建议书一起的其他文档是使用 ditabase DTD 的 XML 格式创作的。 参考资料 在介绍 Darwin 信息分类体系结构和 Darwin 信息分类体系结构的专门化这两篇文章中研读 DITA。 找出如何参加由 Don Day 和 Michael Preistley 主持的 DITA 论坛的讨论。 直接进入由 Don Day 和 Michael Preistley 主持的 DITA 论坛。 关于作者 Michael Priestley Gretchen Hargis 如果您希望与本文章的作者或其所在机构，进一步交流，请联系：畅享网 姜小姐 jill.jiang@amt.com.cn | 021-51096826-112 | 在线联系 |
 CIO职场，强者生存？在2008年，我们将继续看到CIO向商业运营方向发展。与此同时，我们也会看到商业管理人员将与技术管理人员一起竞争CIO岗位。 IT领导者的就职机会虽有不少，但其难度将会大幅提高。2……  防震减灾，IT当关今天，任何的防震救灾体系，都离不开IT技术。地震观测台是数字化的，震害防御需要对以往的地震信息进行数据分析，应急救援要需要现代多样化的通讯技术。如果说，在许多行业，信息技术还只是一…… |
|
|