将Eclipse导航文件转换为DITA导航文件 - 编程入门网

从这张表中，您可以看到一些元素是一样的（例如 <anchor>）或者是非常相似的。这些相似点使得我很容易创建 XSLT 样式表将 TOC 文件转换为 DITA 映射文件。

本文的其余部分描述了一组示例 TOC 文件到 DITA 映射文件的转换。如果阅读时您想更仔细地检查这些示例文件，请下载并解压档案文件 x-ecldita-toc2dita.zip 的根目录中的文件。

下载的档案文件中包括 TOC文件、相应的 DITA 映射文件和 XSLT 样式表（用来转换 TOC 文件）。您可以使用 Web 浏览器、XML 编辑器或文本编辑器查看 TOC 文件。为查看 DITA 映射文件（扩展名为 .ditamap），需要使用 IBM ID Workbench 。

x-ecldita-toc2dita.zip 文件中的 plugins.zip 文件包含来自根目录的 Eclipse TOC 文件，这些 Eclipse TOC 文件被打包到可以安装在 Eclipse 帮助服务器上的两个 Eclipse 插件中。

将Eclipse导航文件转换为DITA导航文件(2)

转换主 TOC 文件

大多数情况下，基于 Eclipse 帮助系统的导航由多个通过中心主 TOC 文件整合的 TOC 文件组成。主文件可以包含以下类型元素的任意组合：

主题（通过 <topic> 元素指定）。

到其他已存在的 TOC 文件的连接（自上而下的整合）。

将来用于扩展主 TOC 的锚（自下而上的整合）。

尽管 Eclipse 帮助系统不需要主 TOC 文件，但是当多个内容提供商必须一起开发同一个帮助系统时使用 TOC 文件是非常方便的。当帮助系统的各个部分（比如通过安装特性而升级的基本产品）是分次安装的时，TOC 文件也是必要的。如果有必要将基本帮助系统与特性帮助内容整合，那么主 TOC 文件是必要的。

下载的档案文件中，主 TOC 文件是 mastertoc.xml。图 1 展示了 mastertoc.xml 文件，它旁边是一个屏幕快照，显示了整合的 TOC 文件是如何呈现在 Eclipse 帮助浏览器中的。主 TOC 文件：

将根集合标记为“Administration Central”并指定一个在用户点击根集合时显示的目录文件。

连接到子集合（toca.xml）。

提供一个锚用于将来扩展主 TOC 文件。

包含一个提醒用户的主题。

图1. mastertoc.xml 的 TOC 部分

将Eclipse导航文件转换为DITA导航文件(3)

当使用 XSLT 样式表（x-ecldita-toc2dita.zip 文件中的 toc2dita_adv.xsl）将主 TOC 文件转换为 DITA 映射文件时，输出文件类似于 清单 1。

清单 1. 转换后的 mastertoc.xml 文件（mastertoc.ditamap）

<?xml　version="1.0"　encoding="UTF-8"?> <!DOCTYPE　map　PUBLIC　"-//IBM//DTD　DITA　Map//EN"　"..\dtd\map.dtd"> <map　title="Administration　Central"> 　<topicref　navtitle="Administration　Central" 　　href="admin_central.dita"　print="no"　toc="no"/> 　<topicref　navtitle="Console　Basics"　href="console_basics.dita"> 　　　<navref　mapref="toca.ditamap"/> 　</topicref> <anchor　id="anchor_id"/> <topicref　navtitle="Notices"　href="reference/notices.dita"/> </map>

虽然示例主 TOC 是简单的，但更复杂的主 TOC 文件也只是示例文件中基本元素的多次重复。XSLT 样式表可以处理复杂 TOC 文件和那些引用除 HTML 之外的其他文件类型的 TOC 文件。最新的 Eclipse 技术支持显示是 JavaServer Page 的源文件。所以 XSLT 样式表可以处理.jsp、.pdf、 .gif、.htm 和 .html 扩展名的文件。

转换子 TOC 文件

本节主要

凌众科技专业提供服务器租用、服务器托管、企业邮局、虚拟主机等服务，公司网站：http://www.lingzhong.cn 为了给广大客户了解更多的技术信息，本技术文章收集来源于网络,凌众科技尊重文章作者的版权，如果有涉及你的版权有必要删除你的文章，请和我们联系。以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!