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

toca.xml 文件通过明确引用 toca.xml 的 <link> 元素而与主 TOC 文件整合在一起，并为集合（Console Basics）分配一个标签，然后指定一个在用户点击集合标签时显示的主题文件。不需要将集合与主题文件关联。在这种情况下，没有指定 href 属性。因为连接涉及关于子 TOC 的特定信息，所以只有在 TOC 文件已经存在，或者开发人员相信在安装主 TOC 文件的 Eclipse 插件时会存在 TOC 文件的情况下，才可能完成这一类型的连接。图 2 右边显示了 toca.xml 文件的内容，左边显示了内容在 Eclipse 帮助浏览器中是如何显示的视图。

图 2. toca.xml 中的 TOC 部分

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

与 toca.xml 比较，tocb.xml 文件通过 <anchor> 而与主 TOC 整合在一起。如果主 TOC 设计者预计未来需要与另一个 TOC 文件整合，开发人员可以在主 TOC 中希望的位置插入锚。未来的 TOC 文件将指向那个锚。虽然允许多个锚，但安装中只有一个 TOC 可以指向具体的锚。tocb.xml 文件中，<toc> 元素的 link_to 属性指向 主 TOC 文件中的锚。图 3 右边展示了 tocb.xml 文件的内容，左边显示了内容在 Eclipse 帮助浏览器中是如何显示的视图。

图 3. tocb.xml 中的 TOC 部分

注意，link_to 属性的值是主 TOC 文件的相对 URL 加上数字符号（＃）和 <anchor> 元素的 id 属性的值。因为 tocb.xml 文件和 mastertoc.xml 文件在两个单独的 Eclipse 插件中，所以相对 URL 包含主 TOC 的插件名称。图 4 和 图 5 展示了两个插件的目录：com.mycompany.plugin.doc （其中包含 mastertoc.xml 和 toca.xml）和 com.mycompany.plugin.adv.doc（其中包含 tocb.xml）。

图 4. com.mycompany.plugin.doc 目录

图 5. com.mycompany.plugin.adv.doc 目录

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

当使用 x-ecldita-toc2dita.zip 文件中的 XSLT 样式表将 tocb.xml 转换为 DITA 映射文件时，输出文件类似于 清单 2。注意，TOC 文件中的 link_to 属性转换为映射文件中的 anchorref 属性。

清单 2. 转换后的 tocb.xml 文件（tocb.ditamap）

<?xml　version="1.0"　encoding="UTF-8"?> <!DOCTYPE　map　PUBLIC　"-//IBM//DTD　DITA　Map//EN"　"..\dtd\map.dtd"> <map　title="Advanced" 　anchorref="../com.mycompany.plugin.doc/mastertoc.ditamap#anchor_id"> 　<topicref　navtitle="Advanced　topics"　href="advanced.dita"> 　　<topicref　navtitle="Adding　resources"　href="tasks/adding_res.dita"/> 　　<topicref　navtitle="Removing　resources"　href="tasks/removing_res.dita"/> 　</topicref> </map>

转换 TOC 文件

您已经看到示例文件的转换。现在可以转换您自己的 Eclipse TOC 文件了。下面是设置系统和运行转换的步骤：

如果您还没有下载档案文件 x-ecldita-toc2dita.zip，请立即下载。

使用 PKZip、WinZip 或类似工具来解压文件。

创建一个文件夹作为您转换的工作区。

将 toc2dita_adv.xsl 文件从 x-ecldita-toc2dita.zip 文件拷贝到您的工作文件夹。

拷贝您的 Eclipse TOC 文件到相同的文件夹。

如果您还没有 XSLT 样式表处理器的拷贝，请获取一份拷贝。例如，要获取 Apa

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