如何为DITA OT生成的每个HTML文件标题添加层级编号？

核心思路 #

要在dita2xhtml_eclipsehelp.xsl中实现目标格式的层级编号，需利用XSLT的<xsl:number>元素追踪标题层级，结合DITA主题的结构（如topic/title、section/title等）匹配不同层级的标题节点。

修改步骤 #

1. 定位标题处理模板
   找到xsl文件中匹配title元素的模板，通常类似：

   <xsl:template match="title">
     <!-- 原有标题输出逻辑 -->
   </xsl:template>
   

2. 插入层级编号生成逻辑
   替换或补充原有模板内容，加入编号生成代码：

   <xsl:template match="title">
     <xsl:variable name="titleNumber">
       <xsl:number count="topic|section" level="multiple" format="1.1.1 "/>
     </xsl:variable>
     <!-- 根据标题层级生成对应h标签，ancestor::*计数调整层级 -->
     <xsl:element name="h{count(ancestor::*) + 1}">
       <xsl:value-of select="$titleNumber"/>
       <xsl:apply-templates/>
     </xsl:element>
   </xsl:template>
   

   • count="topic|section"指定计数的核心元素，topic对应一级标题，section对应子层级
   • level="multiple"生成多级联动编号（如1.1、1.1.1）
   • format="1.1.1 "定义编号格式，末尾空格用于分隔编号与标题文本

3. 适配Eclipse Help结构
   若单个HTML对应独立主题，需确保编号逻辑适配主题嵌套关系：

   • 利用ancestor::轴计算当前标题的层级深度，避免编号重置错误
   • 若涉及topicref嵌套传递层级，可通过自定义参数传递父级编号前缀

4. 验证输出效果
   重新执行DITA OT转换命令，检查生成的HTML文件中标题是否按1 标题文本、1.1 标题文本的格式显示。

注意事项 #

• 若DITA文档使用自定义层级元素（如subtopic），需同步调整count属性中的元素名称
• 可配合CSS调整编号的样式（如缩进、字体权重），避免与Eclipse Help默认样式冲突
• 确保使用XSLT 1.0语法，适配DITA OT的版本要求

内容的提问来源于stack exchange，提问作者Ganapathy