将Eclipse导航文件转化成DITA导航文件
11 浏览量
2020-03-04
10:29:29
上传
评论
收藏 438KB DOC 举报
将 Eclipse 导航文件转化成 DITA 导航文件
使用 mapref 方法代替 navref
级别: 中级
2006 年 9 月 14 日
上一期文章介绍了把 Eclipse 导航文件转化成 Darwin Information Typing
Architecture (DITA) 格式的基础。2005 年 8 月，OASIS DITA Toolkit 1.1 实现了集
成 DITA 导航文件的新方式。这种新功能称为 mapref，可用于代替 navref 元素（上一
期文章中介绍了）集成导航文件。本文比较集成导航文件的 mapref 和 navref 方法。可
以在本文的下载包中找到更新后的 XSLT 样式表，它利用了 mapref 的能力，并对上一期
文章中的样式表作了其他改进。
使用主文件集成导航文件
Eclipse 帮助技术提供了一个内容查看器，可显示一个导航控件区域和一个主题内容区域。
要选择在内容区显示的主题，用户可以单击导航区中的项。Eclipse 帮助服务器使用
Eclipse Table of Contents (TOC) 文件在导航区创建主题层次。
Eclipse TOC 文件支持两种类型的集成：自顶向下和自底向上。这两种集成都在运行时完
成。
运行时
即 Eclipse 帮助服务器启动之后。
自顶向下的集成
即从一个 TOC 文件链接到
更细的 TOC 文件。
自底向上的集成
提供了集成其他 TOC 文件的锚点，可供将来使用。
与 Eclipse 帮助技术一样，OASIS DITA 规范支持集成映射文件。在 OASIS DITA 1.0 规
范之前，集成映射文件的方法就是在 DITA 映射中编写 <navref> 元素嵌入其他的 DITA
映射。<navref> 元素支持将 DITA 映射转换成 Eclipse TOC 文件，但不能转换成其他
导航文件。OASIS DITA 1.0 增加了新的选择，在一个 DITA 映射中可使用专门编写的
<topicref> 元素嵌入其他 DITA 映射。这种编码惯例称为 mapref，不同于 <navref>
元素的 mapref 属性。OASIS DITA Toolkit 1.1 实现了 OASIS DITA 1.0 规范。
本文中的 XSLT 样式表有一个输入参数用于指定使用哪一种集成方法。
新 XSLT 样式表的改进
新的 XSLT 样式表在以下方面作了改进：
支持 navref 参数，它用于指定如何转换 Eclipse <link> 元素。
支持 transformext 参数，它指定 Eclipse <topic> 元素中的 HTML 文件在输
出的 DITA 映射中使用文件扩展名 .dita 还是 .xml。
在转换输出中指定 OASIS DITA DTD 而不是 IBM DITA DTD。
在 Eclipse <topic> 元素中处理 JPEG 文件的引用。
使用 mapref 功能转换主 TOC 文件
将 Eclipse TOC 文件转换成 DITA 映射文件更容易，因为两者都是 XML 文件、以层次化
的方式描述主题。为了利用 mapref 功能，XSLT 样式表支持输入参数 navref，它确定如
何处理 <link> 元素。Eclipse TOC 文件中的 <link> 元素嵌入其他 TOC 文件。如果
navref 参数设置为 “no”，那么源 TOC 文件中的 <link> 就被转换成 DITA 输出文件中
的 mapref。若将 navref 参数设为 “yes”，则 <link> 将转换成 <navref> 元素。
评论0
最新资源