将Eclipse导航文件转换为DITA导航文件[Java编程]
本文“将Eclipse导航文件转换为DITA导航文件[Java编程]”是由七道奇为您精心收集,来源于网络转载,文章版权归文章作者所有,本站不对其观点以及内容做任何评价,请读者自行判断,以下是其具体内容:
本文描写了若何完成移植历程中转换工具所不能自动完成的任务:将 Eclipse TOC 文件转换为 DITA 映射文件.这里并没有谈论将 HTML 文件转换为 DITA 格局的缘由,OASIS DITA Web 站点上的其他 developerWorks 文章和参考资料将会注释其上风.本文对比了两个基于 XML 的导航文件中的元素,然后利用示例主 TOC 文件和次 TOC 文件演示到 DITA 的转换.还为利用 XSLT 款式表对 Eclipse TOC 文件举行转换供应了指导.
弥补当前工具的空白
假如需求将 Eclipse 帮忙插件转换为 DITA,您可以找到将 HTML 文件转换为 XHTML 和将 XHTML 转换为 DITA 的工具.固然 Eclipse 帮忙插件中的大大都文件普通是 HTML,但 Eclipse TOC 文件仍耗费了大量的计划与开辟时间.基于 TOC 文件存在几个要素:信息构造、搜索数据库目录和关键主题的可见性.假如您已经对 TOC 文件投入了大量精神并且文件工作得如您所愿,您决不会冒险用手动办法将文件转换为 DITA 映射文件 —— 除非幸运地找处处理该任务的转换工具.在我没有找到这样的工具之后,我决意自己编写 XSLT 款式表来转换文件.
比较 Eclipse TOC 与 DITA 映射
Eclipse TOC 文件和 DITA 映射文件都是用来为一组主题描写导航的 XML 文件.您会发现两种范例文件间的类似点与差别点.关于 Eclipse TOC 文件中的每一个合理元素或属性,表 1 列出了 DITA 映射文件中的呼应元素.每一个 TOC 元素的属性列在该元素背面.
表 1. Eclipse TOC 元素与 DITA 映射元素的一一对比
TOC 元素或属性 | 映射元素或属性 | 注释 |
<toc> | <map> | 它们是文档的根元素 |
link_to | anchorref | 这些属性指向另一个主题层次构造中的插入点(TOC 或 DITA 映射文件).该主题层次构造与另一个主题层次构造在插入点整合.这也称为自下而上的整合. |
label | title | label 属性是 <toc> 元素所必须的. |
topic | <topicref> | DITA 映射中的第一个 <topicref> 元素用来保存 Eclipse TOC 文件中 <toc> 元素的 topic 属性.topic 属性的值用来设置 <topicref> 的 href 属性值.<topicref> 元素的 print 和 toc 属性被设置为 "no". |
<topic> | <topicref> | 假如<topic>元素没有 href 属性,那么您可以将 <topic> 元素转换为 <topichead> 元素. |
label | navtitle | label 属性是 <topic> 元素所必须的. |
href | href | <topic> 元素的 href 属性值用来设置 <topicref> 元素的 href 属性值. |
<anchor> | <anchor> | 这些元素定义了其他主题层次构造可以衔接(<toc> 元素的 link_to 属性)或参考(<map> 元素的 anchorref 属性)的插入点. |
id | id | id 属性是 <anchor> 元素所必须的. |
<link> | <navref> | 这些元素指向另一个主题层次构造.另一个主题层次构造在该插入点与此主题层次构造整合.这也称为自上而下的整合. |
toc | mapref | toc 属性是 <topic> 元素所必须的. |
从这张表中,您可以看到一些元素是一样的(比方 <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导航文件[Java编程]”的内容,如果你对以上该文章内容感兴趣,你可以看看七道奇为您推荐以下文章:
本文地址: | 与您的QQ/BBS好友分享! |