Eclipse TOC转DITA：mapref替代navref的高级集成

本文主要探讨了如何将Eclipse提供的导航文件转换为DITA（Darwin Information Typing Architecture）导航文件，特别是在OASIS DITA Toolkit 1.1版本引入的mapref方法，以替代传统的navref元素。Eclipse的帮助技术利用Table of Contents (TOC) 文件实现自顶向下和自底向上两种导航集成，这些集成在Eclipse帮助服务器启动后实时进行。 Eclipse TOC文件支持两种集成策略：自顶向下，即从一个高层次的TOC文件链接到更具体的内容；自底向上，通过提供锚点来集成其他TOC文件，便于后续扩展。在DITA领域，以前的集成通常是通过<navref>元素嵌套映射，但这种方法存在局限性，只能转换成Eclipse TOC文件，而不能转换为其他导航文件格式。 OASIS DITA 1.0规范引入了mapref元素作为新的集成机制，允许在一个DITA映射中嵌入其他DITA映射，从而突破了<navref>的限制。mapref是DITA中的一个专门编码方式，不同于<navref>的mapref属性。OASIS DITA Toolkit 1.1实现了这一规范，使得导航文件的转换更为灵活和兼容。 作者Loretta Hicks作为高级软件工程师，提供了更新后的XSLT样式表，这个样式表支持mapref方法，并对原有样式表进行了优化。新样式表的特点包括对navref参数的支持，可以指定转换过程中的特定行为，这使得开发者可以根据需求选择适合的集成策略。 总结来说，本文的核心知识点包括： 1. Eclipse TOC文件的导航集成方法及其运行时特性。 2. mapref和navref在DITA导航文件集成中的对比和作用。 3. OASIS DITA 1.0和1.1规范对导航文件集成的新改进，特别是mapref元素的引入。 4. 使用XSLT样式表实现Eclipse TOC文件到DITA映射的转换，以及新样式表的优化细节。 通过这篇文章，读者可以了解到如何有效地将Eclipse的导航结构转化为DITA格式，以便于在不同的帮助系统和文档环境中使用。