简体中文 繁體中文 English 日本語 Deutsch 한국 사람 بالعربية TÜRKÇE português คนไทย Français

开启辅助访问 切换到宽版

站内搜索

搜索

活动公告

通知：是的！我们正在计划一个大动作！
11-02 12:46
通知：Telegram 推送频道https://t.me/+2tB3a7aKXlw2YjA1 及时接收第一手论坛帖子信息～
10-23 09:32
通知：本站资源由网友上传分享，如有违规等问题请到版务模块进行投诉，将及时处理！
10-23 09:31
通知：加入QQ社群吧 https://qm.qq.com/q/QZibQd1hiq
10-23 09:28
通知：签到时间调整为每日4:00（东八区）
10-23 09:26
>社区 > 科技 > 经验交流 >帖子
本版发帖返回

XSL FO文档索引制作全指南从基础入门到高级应用技巧详解如何利用这一强大工具创建专业文档索引提升信息检索效率

威震华夏关云长

3万

主题

349

科技点

3万

积分

大区版主

木柜子打湿

积分
31898

三倍冰淇淋无人之境【一阶】财Doro小樱（小丑装）立华奏以外的星空【二阶】⑨的冰沙
发表于 2025-9-10 19:10:01 | 显示全部楼层 |阅读模式

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要 登录 才可以下载或查看，没有账号？立即注册

x
引言

XSL FO（Extensible Stylesheet Language Formatting Objects）是一种强大的标记语言，专门用于格式化XML数据，特别适合创建高质量的打印文档和PDF文件。在专业文档制作过程中，索引是一个至关重要的组成部分，它不仅能显著提升信息检索效率，还能大大改善用户体验。本文将全面介绍如何使用XSL FO创建专业级的文档索引，从基础概念到高级应用技巧，帮助读者掌握这一强大工具，提升文档的专业性和可用性。

XSL FO基础

什么是XSL FO？

XSL FO是W3C推荐的一种标准，用于描述文档的格式和布局。它是XSL（Extensible Stylesheet Language）的一部分，专门负责文档的呈现层面。与HTML或CSS不同，XSL FO更加关注打印媒体和分页文档的精确控制。

XSL FO文档结构

一个基本的XSL FO文档由以下部分组成：
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
  4.   <fo:layout-master-set>
  5.     <!-- 定义页面布局 -->
  6.   </fo:layout-master-set>
  7.   
  8.   <fo:page-sequence master-reference="main">
  9.     <fo:flow flow-name="xsl-region-body">
  10.       <!-- 文档内容 -->
  11.     </fo:flow>
  12.   </fo:page-sequence>
  13. </fo:root>
复制代码

XSL FO处理流程

XSL FO文档通常通过以下流程生成：

1. 创建源XML文档
2. 编写XSLT样式表将XML转换为XSL FO
3. 使用XSL FO处理器（如Apache FOP或RenderX）将XSL FO转换为PDF或其他格式

索引的基本概念

什么是索引？

索引是文档末尾的一个有序列表，包含重要术语、概念和它们在文档中出现的位置。良好的索引应该：

• 全面：覆盖文档中的重要内容
• 精确：准确指向相关内容
• 一致：使用统一的术语和格式
• 用户友好：考虑到用户的检索习惯

索引的类型

常见的索引类型包括：

1. 主题索引：按主题或概念组织
2. 作者索引：按作者姓名组织
3. 图表索引：列出所有图表及其位置
4. 法律文档索引：按法规、案例等组织

使用XSL FO创建简单索引

准备工作

在创建索引之前，我们需要：

1. 在源XML文档中标记索引条目
2. 创建XSLT样式表提取这些条目
3. 在XSL FO中格式化索引

标记索引条目

首先，在源XML文档中添加索引标记：
  2. <book>
  3.   <chapter>
  4.     <title>Introduction</title>
  5.     <para>This is about <index-term term="XSL FO"/>XSL FO formatting.</para>
  6.     <para>More text about <index-term term="Formatting Objects"/>Formatting Objects.</para>
  7.   </chapter>
  8. </book>
复制代码

创建基本索引XSLT

接下来，创建XSLT样式表来提取和格式化索引：
  2. <xsl:stylesheet version="1.0"
  3.   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  4.   xmlns:fo="http://www.w3.org/1999/XSL/Format">
  5.   
  6.   <!-- 提取所有索引条目 -->
  7.   <xsl:key name="index-terms" match="index-term" use="@term"/>
  8.   
  9.   <!-- 主模板 -->
  10.   <xsl:template match="/">
  11.     <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
  12.       <fo:layout-master-set>
  13.         <fo:simple-page-master master-name="main" page-height="29.7cm" page-width="21cm">
  14.           <fo:region-body margin="2cm"/>
  15.         </fo:simple-page-master>
  16.       </fo:layout-master-set>
  17.       
  18.       <fo:page-sequence master-reference="main">
  19.         <fo:flow flow-name="xsl-region-body">
  20.           <!-- 处理文档内容 -->
  21.           <xsl:apply-templates select="book"/>
  22.          
  23.           <!-- 生成索引 -->
  24.           <fo:block break-before="page" font-size="18pt" font-weight="bold" margin-bottom="12pt">
  25.             Index
  26.           </fo:block>
  27.           <xsl:call-template name="generate-index"/>
  28.         </fo:flow>
  29.       </fo:page-sequence>
  30.     </fo:root>
  31.   </xsl:template>
  32.   
  33.   <!-- 生成索引的模板 -->
  34.   <xsl:template name="generate-index">
  35.     <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  36.       <xsl:sort select="@term"/>
  37.       <fo:block margin-bottom="6pt">
  38.         <xsl:value-of select="@term"/>
  39.         <xsl:text>, </xsl:text>
  40.         <xsl:for-each select="key('index-terms', @term)">
  41.           <xsl:value-of select="ancestor::chapter/title"/>
  42.           <xsl:if test="position() != last()">, </xsl:if>
  43.         </xsl:for-each>
  44.       </fo:block>
  45.     </xsl:for-each>
  46.   </xsl:template>
  47.   
  48.   <!-- 处理其他元素 -->
  49.   <xsl:template match="chapter">
  50.     <fo:block break-before="page" font-size="16pt" font-weight="bold" margin-bottom="10pt">
  51.       <xsl:value-of select="title"/>
  52.     </fo:block>
  53.     <xsl:apply-templates select="para"/>
  54.   </xsl:template>
  55.   
  56.   <xsl:template match="para">
  57.     <fo:block margin-bottom="8pt">
  58.       <xsl:apply-templates/>
  59.     </fo:block>
  60.   </xsl:template>
  61.   
  62.   <xsl:template match="index-term">
  63.     <!-- 索引术语在正文中不显示 -->
  64.     <xsl:apply-templates/>
  65.   </xsl:template>
  66. </xsl:stylesheet>
复制代码

这个基本示例会创建一个简单的索引，列出所有标记的术语及其出现的章节。但我们可以进一步改进和完善它。

索引的高级功能

分组索引条目

在专业索引中，通常需要将相关术语分组。我们可以通过修改XSLT来实现这一点：
  2. <xsl:template name="generate-index">
  3.   <!-- 按首字母分组 -->
  4.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  5.     <xsl:sort select="@term"/>
  6.     <xsl:variable name="current-letter" select="substring-upper(@term, 1, 1)"/>
  7.     <xsl:if test="not(preceding-sibling::index-term[substring-upper(@term, 1, 1) = $current-letter])">
  8.       <fo:block font-weight="bold" margin-top="12pt" margin-bottom="6pt">
  9.         <xsl:value-of select="$current-letter"/>
  10.       </fo:block>
  11.     </xsl:if>
  12.    
  13.     <fo:block margin-left="12pt" margin-bottom="6pt">
  14.       <xsl:value-of select="@term"/>
  15.       <xsl:text>, </xsl:text>
  16.       <xsl:for-each select="key('index-terms', @term)">
  17.         <xsl:value-of select="ancestor::chapter/title"/>
  18.         <xsl:if test="position() != last()">, </xsl:if>
  19.       </xsl:for-each>
  20.     </fo:block>
  21.   </xsl:for-each>
  22. </xsl:template>
复制代码

多级索引

对于复杂文档，可能需要多级索引：
  2. <!-- 在源XML中添加多级索引标记 -->
  3. <para>This is about <index-term term="XSL FO" subterm="basic concepts"/>XSL FO basic concepts.</para>
  4. <para>More text about <index-term term="XSL FO" subterm="advanced features"/>XSL FO advanced features.</para>
  6. <!-- 修改XSLT以处理多级索引 -->
  7. <xsl:key name="index-terms" match="index-term" use="@term"/>
  8. <xsl:key name="subterms" match="index-term" use="concat(@term, '::', @subterm)"/>
  10. <xsl:template name="generate-index">
  11.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  12.     <xsl:sort select="@term"/>
  13.     <xsl:variable name="current-term" select="@term"/>
  14.    
  15.     <!-- 主术语 -->
  16.     <fo:block margin-bottom="6pt">
  17.       <xsl:value-of select="@term"/>
  18.       <xsl:text>, </xsl:text>
  19.       <xsl:for-each select="key('index-terms', @term)[not(@subterm)]">
  20.         <xsl:value-of select="ancestor::chapter/title"/>
  21.         <xsl:if test="position() != last()">, </xsl:if>
  22.       </xsl:for-each>
  23.     </fo:block>
  24.    
  25.     <!-- 子术语 -->
  26.     <xsl:for-each select="//index-term[@term = $current-term and @subterm][generate-id() = generate-id(key('subterms', concat(@term, '::', @subterm))[1])]">
  27.       <xsl:sort select="@subterm"/>
  28.       <fo:block margin-left="12pt" margin-bottom="6pt">
  29.         <xsl:value-of select="@subterm"/>
  30.         <xsl:text>, </xsl:text>
  31.         <xsl:for-each select="key('subterms', concat(@term, '::', @subterm))">
  32.           <xsl:value-of select="ancestor::chapter/title"/>
  33.           <xsl:if test="position() != last()">, </xsl:if>
  34.         </xsl:for-each>
  35.       </fo:block>
  36.     </xsl:for-each>
  37.   </xsl:for-each>
  38. </xsl:template>
复制代码

交叉引用

索引中的交叉引用可以帮助用户找到相关术语：
  2. <!-- 在源XML中添加交叉引用 -->
  3. <index-term term="Formatting Objects" see="XSL FO"/>
  5. <!-- 修改XSLT以处理交叉引用 -->
  6. <xsl:template name="generate-index">
  7.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  8.     <xsl:sort select="@term"/>
  9.     <fo:block margin-bottom="6pt">
  10.       <xsl:value-of select="@term"/>
  11.       <xsl:choose>
  12.         <xsl:when test="@see">
  13.           <xsl:text> see </xsl:text>
  14.           <xsl:value-of select="@see"/>
  15.         </xsl:when>
  16.         <xsl:otherwise>
  17.           <xsl:text>, </xsl:text>
  18.           <xsl:for-each select="key('index-terms', @term)">
  19.             <xsl:value-of select="ancestor::chapter/title"/>
  20.             <xsl:if test="position() != last()">, </xsl:if>
  21.           </xsl:for-each>
  22.         </xsl:otherwise>
  23.       </xsl:choose>
  24.     </fo:block>
  25.   </xsl:for-each>
  26. </xsl:template>
复制代码

页码范围

当术语在连续多页出现时，使用页码范围更为简洁：
  2. <xsl:template name="generate-index">
  3.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  4.     <xsl:sort select="@term"/>
  5.     <fo:block margin-bottom="6pt">
  6.       <xsl:value-of select="@term"/>
  7.       <xsl:text>, </xsl:text>
  8.       
  9.       <!-- 获取并排序页码 -->
  10.       <xsl:variable name="pages">
  11.         <xsl:for-each select="key('index-terms', @term)">
  12.           <page>
  13.             <xsl:value-of select="ancestor::chapter/title"/>
  14.           </page>
  15.         </xsl:for-each>
  16.       </xsl:variable>
  17.       
  18.       <!-- 输出页码或范围 -->
  19.       <xsl:call-template name="format-page-ranges">
  20.         <xsl:with-param name="pages" select="$pages"/>
  21.       </xsl:call-template>
  22.     </fo:block>
  23.   </xsl:for-each>
  24. </xsl:template>
  26. <xsl:template name="format-page-ranges">
  27.   <xsl:param name="pages"/>
  28.   <xsl:param name="position" select="1"/>
  29.   
  30.   <xsl:if test="$position &lt;= count($pages/page)">
  31.     <xsl:variable name="current" select="$pages/page[$position]"/>
  32.     <xsl:variable name="next" select="$pages/page[$position + 1]"/>
  33.    
  34.     <xsl:choose>
  35.       <xsl:when test="$next and $next = $current + 1">
  36.         <!-- 开始一个范围 -->
  37.         <xsl:value-of select="$current"/>
  38.         <xsl:text>–</xsl:text>
  39.         
  40.         <!-- 找到范围的结束 -->
  41.         <xsl:call-template name="find-range-end">
  42.           <xsl:with-param name="pages" select="$pages"/>
  43.           <xsl:with-param name="start" select="$position + 1"/>
  44.           <xsl:with-param name="expected" select="$current + 2"/>
  45.         </xsl:call-template>
  46.       </xsl:when>
  47.       <xsl:otherwise>
  48.         <xsl:value-of select="$current"/>
  49.         <xsl:if test="$position &lt; count($pages/page)">
  50.           <xsl:text>, </xsl:text>
  51.         </xsl:if>
  52.       </xsl:otherwise>
  53.     </xsl:choose>
  54.    
  55.     <!-- 处理下一页 -->
  56.     <xsl:call-template name="format-page-ranges">
  57.       <xsl:with-param name="pages" select="$pages"/>
  58.       <xsl:with-param name="position" select="$position + 1"/>
  59.     </xsl:call-template>
  60.   </xsl:if>
  61. </xsl:template>
  63. <xsl:template name="find-range-end">
  64.   <xsl:param name="pages"/>
  65.   <xsl:param name="start"/>
  66.   <xsl:param name="expected"/>
  67.   
  68.   <xsl:choose>
  69.     <xsl:when test="$start &lt;= count($pages/page) and $pages/page[$start] = $expected">
  70.       <!-- 继续查找 -->
  71.       <xsl:call-template name="find-range-end">
  72.         <xsl:with-param name="pages" select="$pages"/>
  73.         <xsl:with-param name="start" select="$start + 1"/>
  74.         <xsl:with-param name="expected" select="$expected + 1"/>
  75.       </xsl:call-template>
  76.     </xsl:when>
  77.     <xsl:otherwise>
  78.       <!-- 输出范围结束 -->
  79.       <xsl:value-of select="$pages/page[$start - 1]"/>
  80.       <xsl:if test="$start &lt;= count($pages/page)">
  81.         <xsl:text>, </xsl:text>
  82.       </xsl:if>
  83.       
  84.       <!-- 继续处理剩余页码 -->
  85.       <xsl:call-template name="format-page-ranges">
  86.         <xsl:with-param name="pages" select="$pages"/>
  87.         <xsl:with-param name="position" select="$start"/>
  88.       </xsl:call-template>
  89.     </xsl:otherwise>
  90.   </xsl:choose>
  91. </xsl:template>
复制代码

索引样式定制

字体和间距

自定义索引的字体和间距可以提升可读性：
  2. <xsl:template name="generate-index">
  3.   <fo:block font-family="Arial, sans-serif" font-size="10pt">
  4.     <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  5.       <xsl:sort select="@term"/>
  6.       <fo:block margin-bottom="4pt" text-indent="-12pt" start-indent="12pt">
  7.         <fo:inline font-weight="bold">
  8.           <xsl:value-of select="@term"/>
  9.         </fo:inline>
  10.         <fo:inline>
  11.           <xsl:text>, </xsl:text>
  12.           <xsl:for-each select="key('index-terms', @term)">
  13.             <xsl:value-of select="ancestor::chapter/title"/>
  14.             <xsl:if test="position() != last()">, </xsl:if>
  15.           </xsl:for-each>
  16.         </fo:inline>
  17.       </fo:block>
  18.     </xsl:for-each>
  19.   </fo:block>
  20. </xsl:template>
复制代码

分栏布局

对于大型索引，使用分栏布局可以节省空间并提高可读性：
  2. <fo:flow flow-name="xsl-region-body">
  3.   <!-- 处理文档内容 -->
  4.   <xsl:apply-templates select="book"/>
  5.   
  6.   <!-- 生成索引 -->
  7.   <fo:block break-before="page" font-size="18pt" font-weight="bold" margin-bottom="12pt">
  8.     Index
  9.   </fo:block>
  10.   
  11.   <fo:block-container>
  12.     <fo:block font-family="Arial, sans-serif" font-size="10pt">
  13.       <fo:table table-layout="fixed" width="100%">
  14.         <fo:table-column column-width="50%"/>
  15.         <fo:table-column column-width="50%"/>
  16.         <fo:table-body>
  17.           <fo:table-row>
  18.             <fo:table-cell>
  19.               <fo:block>
  20.                 <!-- 第一列索引 -->
  21.                 <xsl:call-template name="generate-index-column">
  22.                   <xsl:with-param name="terms" select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])][position() mod 2 = 1]"/>
  23.                 </xsl:call-template>
  24.               </fo:block>
  25.             </fo:table-cell>
  26.             <fo:table-cell>
  27.               <fo:block>
  28.                 <!-- 第二列索引 -->
  29.                 <xsl:call-template name="generate-index-column">
  30.                   <xsl:with-param name="terms" select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])][position() mod 2 = 0]"/>
  31.                 </xsl:call-template>
  32.               </fo:block>
  33.             </fo:table-cell>
  34.           </fo:table-row>
  35.         </fo:table-body>
  36.       </fo:table>
  37.     </fo:block>
  38.   </fo:block-container>
  39. </fo:flow>
  41. <xsl:template name="generate-index-column">
  42.   <xsl:param name="terms"/>
  43.   <xsl:for-each select="$terms">
  44.     <xsl:sort select="@term"/>
  45.     <fo:block margin-bottom="4pt" text-indent="-12pt" start-indent="12pt">
  46.       <fo:inline font-weight="bold">
  47.         <xsl:value-of select="@term"/>
  48.       </fo:inline>
  49.       <fo:inline>
  50.         <xsl:text>, </xsl:text>
  51.         <xsl:for-each select="key('index-terms', @term)">
  52.           <xsl:value-of select="ancestor::chapter/title"/>
  53.           <xsl:if test="position() != last()">, </xsl:if>
  54.         </xsl:for-each>
  55.       </fo:inline>
  56.     </fo:block>
  57.   </xsl:for-each>
  58. </xsl:template>
复制代码

制表符和对齐

使用制表符可以确保页码对齐：
  2. <xsl:template name="generate-index">
  3.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  4.     <xsl:sort select="@term"/>
  5.     <fo:block margin-bottom="4pt" text-align-last="justify">
  6.       <fo:inline font-weight="bold">
  7.         <xsl:value-of select="@term"/>
  8.       </fo:inline>
  9.       <fo:leader leader-pattern="dots"/>
  10.       <fo:inline>
  11.         <xsl:for-each select="key('index-terms', @term)">
  12.           <xsl:value-of select="ancestor::chapter/title"/>
  13.           <xsl:if test="position() != last()">, </xsl:if>
  14.         </xsl:for-each>
  15.       </fo:inline>
  16.     </fo:block>
  17.   </xsl:for-each>
  18. </xsl:template>
复制代码

自动化索引生成

使用XSLT自动标记索引条目

对于大型文档，手动标记每个索引条目可能很耗时。我们可以编写XSLT自动识别并标记潜在索引条目：
  2. <xsl:stylesheet version="1.0"
  3.   xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  4.   
  5.   <!-- 定义应该被索引的术语列表 -->
  6.   <xsl:variable name="index-terms" select="document('index-terms.xml')/terms/term"/>
  7.   
  8.   <!-- 处理文本节点，查找索引术语 -->
  9.   <xsl:template match="text()">
  10.     <xsl:param name="text" select="."/>
  11.     <xsl:choose>
  12.       <!-- 检查是否有匹配的索引术语 -->
  13.       <xsl:when test="$index-terms[contains($text, .)]">
  14.         <xsl:call-template name="process-text">
  15.           <xsl:with-param name="text" select="$text"/>
  16.         </xsl:call-template>
  17.       </xsl:when>
  18.       <xsl:otherwise>
  19.         <xsl:value-of select="$text"/>
  20.       </xsl:otherwise>
  21.     </xsl:choose>
  22.   </xsl:template>
  23.   
  24.   <!-- 处理文本，添加索引标记 -->
  25.   <xsl:template name="process-text">
  26.     <xsl:param name="text"/>
  27.    
  28.     <!-- 找到最早出现的索引术语 -->
  29.     <xsl:variable name="earliest-term">
  30.       <xsl:for-each select="$index-terms[contains($text, .)]">
  31.         <term pos="{string-length(substring-before($text, .))}" value="{.}"/>
  32.       </xsl:for-each>
  33.     </xsl:variable>
  34.    
  35.     <xsl:variable name="first-term" select="$earliest-term/term[@pos = min($earliest-term/term/@pos)][1]"/>
  36.    
  37.     <!-- 输出术语前的文本 -->
  38.     <xsl:value-of select="substring($text, 1, $first-term/@pos)"/>
  39.    
  40.     <!-- 添加索引标记 -->
  41.     <index-term term="{$first-term/@value}">
  42.       <xsl:value-of select="$first-term/@value"/>
  43.     </index-term>
  44.    
  45.     <!-- 处理剩余文本 -->
  46.     <xsl:call-template name="process-text">
  47.       <xsl:with-param name="text" select="substring-after($text, $first-term/@value)"/>
  48.     </xsl:call-template>
  49.   </xsl:template>
  50.   
  51.   <!-- 复制其他元素 -->
  52.   <xsl:template match="@*|node()">
  53.     <xsl:copy>
  54.       <xsl:apply-templates select="@*|node()"/>
  55.     </xsl:copy>
  56.   </xsl:template>
  57. </xsl:stylesheet>
复制代码

使用正则表达式识别索引术语

更高级的方法是使用正则表达式识别索引术语：
  2. <xsl:stylesheet version="2.0"
  3.   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  4.   xmlns:xs="http://www.w3.org/2001/XMLSchema"
  5.   xmlns:my="http://example.com/my"
  6.   exclude-result-prefixes="xs my">
  7.   
  8.   <!-- 定义索引术语的正则表达式模式 -->
  9.   <xsl:variable name="index-pattern" select="'\b(XSL FO|Formatting Objects|XML|XPath)\b'"/>
  10.   
  11.   <!-- 处理文本节点 -->
  12.   <xsl:template match="text()">
  13.     <xsl:analyze-string select="." regex="{$index-pattern}">
  14.       <xsl:matching-substring>
  15.         <index-term term="{.}">
  16.           <xsl:value-of select="."/>
  17.         </index-term>
  18.       </xsl:matching-substring>
  19.       <xsl:non-matching-substring>
  20.         <xsl:value-of select="."/>
  21.       </xsl:non-matching-substring>
  22.     </xsl:analyze-string>
  23.   </xsl:template>
  24.   
  25.   <!-- 复制其他元素 -->
  26.   <xsl:template match="@*|node()">
  27.     <xsl:copy>
  28.       <xsl:apply-templates select="@*|node()"/>
  29.     </xsl:copy>
  30.   </xsl:template>
  31. </xsl:stylesheet>
复制代码

性能优化

处理大型文档索引

对于大型文档，索引生成可能会变得很慢。以下是一些优化技巧：

1. 使用键（key）提高效率：
  2. <xsl:key name="index-terms" match="index-term" use="@term"/>
复制代码

1. 分阶段处理：
  2. <xsl:stylesheet version="1.0"
  3.   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  4.   xmlns:fo="http://www.w3.org/1999/XSL/Format"
  5.   xmlns:idx="http://example.com/index"
  6.   exclude-result-prefixes="idx">
  7.   
  8.   <!-- 第一阶段：收集索引条目 -->
  9.   <xsl:variable name="index-entries">
  10.     <idx:entries>
  11.       <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  12.         <xsl:sort select="@term"/>
  13.         <idx:entry term="{@term}">
  14.           <xsl:for-each select="key('index-terms', @term)">
  15.             <idx:location>
  16.               <xsl:value-of select="ancestor::chapter/title"/>
  17.             </idx:location>
  18.           </xsl:for-each>
  19.         </idx:entry>
  20.       </xsl:for-each>
  21.     </idx:entries>
  22.   </xsl:variable>
  23.   
  24.   <!-- 第二阶段：生成文档和索引 -->
  25.   <xsl:template match="/">
  26.     <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
  27.       <!-- 文档内容 -->
  28.       <fo:layout-master-set>
  29.         <fo:simple-page-master master-name="main" page-height="29.7cm" page-width="21cm">
  30.           <fo:region-body margin="2cm"/>
  31.         </fo:simple-page-master>
  32.       </fo:layout-master-set>
  33.       
  34.       <fo:page-sequence master-reference="main">
  35.         <fo:flow flow-name="xsl-region-body">
  36.           <!-- 处理文档内容 -->
  37.           <xsl:apply-templates select="book"/>
  38.          
  39.           <!-- 生成索引 -->
  40.           <fo:block break-before="page" font-size="18pt" font-weight="bold" margin-bottom="12pt">
  41.             Index
  42.           </fo:block>
  43.           <xsl:apply-templates select="$index-entries"/>
  44.         </fo:flow>
  45.       </fo:page-sequence>
  46.     </fo:root>
  47.   </xsl:template>
  48.   
  49.   <!-- 处理索引条目 -->
  50.   <xsl:template match="idx:entries">
  51.     <fo:block font-family="Arial, sans-serif" font-size="10pt">
  52.       <xsl:apply-templates select="idx:entry"/>
  53.     </fo:block>
  54.   </xsl:template>
  55.   
  56.   <xsl:template match="idx:entry">
  57.     <fo:block margin-bottom="4pt" text-indent="-12pt" start-indent="12pt">
  58.       <fo:inline font-weight="bold">
  59.         <xsl:value-of select="@term"/>
  60.       </fo:inline>
  61.       <fo:inline>
  62.         <xsl:text>, </xsl:text>
  63.         <xsl:for-each select="idx:location">
  64.           <xsl:value-of select="."/>
  65.           <xsl:if test="position() != last()">, </xsl:if>
  66.         </xsl:for-each>
  67.       </fo:inline>
  68.     </fo:block>
  69.   </xsl:template>
  70.   
  71.   <!-- 处理其他元素 -->
  72.   <xsl:template match="chapter">
  73.     <fo:block break-before="page" font-size="16pt" font-weight="bold" margin-bottom="10pt">
  74.       <xsl:value-of select="title"/>
  75.     </fo:block>
  76.     <xsl:apply-templates select="para"/>
  77.   </xsl:template>
  78.   
  79.   <xsl:template match="para">
  80.     <fo:block margin-bottom="8pt">
  81.       <xsl:apply-templates/>
  82.     </fo:block>
  83.   </xsl:template>
  84.   
  85.   <xsl:template match="index-term">
  86.     <!-- 索引术语在正文中不显示 -->
  87.     <xsl:apply-templates/>
  88.   </xsl:template>
  89. </xsl:stylesheet>
复制代码

1. 使用XSLT 2.0或更高版本：XSLT 2.0及更高版本提供了更强大的功能和更好的性能。

内存优化

对于非常大的文档，内存可能成为问题。以下是一些减少内存使用的技巧：

1. 使用SAX解析器：SAX解析器比DOM解析器更节省内存。
2. 分块处理：将文档分成较小的块处理：

使用SAX解析器：SAX解析器比DOM解析器更节省内存。

分块处理：将文档分成较小的块处理：
  2. <xsl:stylesheet version="2.0"
  3.   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  4.   xmlns:fo="http://www.w3.org/1999/XSL/Format"
  5.   xmlns:xs="http://www.w3.org/2001/XMLSchema"
  6.   exclude-result-prefixes="xs">
  7.   
  8.   <!-- 使用collection()函数处理多个文件 -->
  9.   <xsl:template name="process-large-document">
  10.     <xsl:for-each select="collection('docs/?select=*.xml')">
  11.       <xsl:apply-templates select="."/>
  12.     </xsl:for-each>
  13.   </xsl:template>
  14. </xsl:stylesheet>
复制代码

1. 使用流处理：XSLT 3.0支持流处理，可以处理非常大的文件而不会耗尽内存。

实际案例研究

技术手册索引

技术手册通常需要详细的索引，包括术语、命令、函数等：
  2. <!-- 示例：技术手册索引条目 -->
  3. <para>The <index-term term="configure" subterm="command"/>configure command
  4. is used to set system parameters. See also
  5. <index-term term="setup" subterm="process" see="configure"/>setup process.</para>
  7. <!-- 技术手册索引XSLT -->
  8. <xsl:template name="generate-technical-index">
  9.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  10.     <xsl:sort select="@term"/>
  11.     <fo:block margin-bottom="6pt">
  12.       <fo:inline font-weight="bold" font-family="Courier New, monospace">
  13.         <xsl:value-of select="@term"/>
  14.       </fo:inline>
  15.       <xsl:choose>
  16.         <xsl:when test="@see">
  17.           <xsl:text> see </xsl:text>
  18.           <fo:inline font-family="Courier New, monospace">
  19.             <xsl:value-of select="@see"/>
  20.           </fo:inline>
  21.         </xsl:when>
  22.         <xsl:otherwise>
  23.           <xsl:text>, </xsl:text>
  24.           <xsl:for-each select="key('index-terms', @term)[not(@subterm)]">
  25.             <xsl:value-of select="ancestor::chapter/title"/>
  26.             <xsl:if test="position() != last()">, </xsl:if>
  27.           </xsl:for-each>
  28.         </xsl:otherwise>
  29.       </xsl:choose>
  30.     </fo:block>
  31.    
  32.     <!-- 子术语 -->
  33.     <xsl:for-each select="//index-term[@term = current()/@term and @subterm][generate-id() = generate-id(key('subterms', concat(@term, '::', @subterm))[1])]">
  34.       <xsl:sort select="@subterm"/>
  35.       <fo:block margin-left="12pt" margin-bottom="6pt">
  36.         <fo:inline font-family="Courier New, monospace">
  37.           <xsl:value-of select="@subterm"/>
  38.         </fo:inline>
  39.         <xsl:choose>
  40.           <xsl:when test="@see">
  41.             <xsl:text> see </xsl:text>
  42.             <fo:inline font-family="Courier New, monospace">
  43.               <xsl:value-of select="@see"/>
  44.             </fo:inline>
  45.           </xsl:when>
  46.           <xsl:otherwise>
  47.             <xsl:text>, </xsl:text>
  48.             <xsl:for-each select="key('subterms', concat(@term, '::', @subterm))">
  49.               <xsl:value-of select="ancestor::chapter/title"/>
  50.               <xsl:if test="position() != last()">, </xsl:if>
  51.             </xsl:for-each>
  52.           </xsl:otherwise>
  53.         </xsl:choose>
  54.       </fo:block>
  55.     </xsl:for-each>
  56.   </xsl:for-each>
  57. </xsl:template>
复制代码

法律文档索引

法律文档索引需要精确引用和特殊的格式：
  2. <!-- 示例：法律文档索引条目 -->
  3. <para>According to <index-term term="Copyright Act" section="107(3)"/>Copyright Act § 107(3),
  4. fair use includes the purpose and character of the use. See also
  5. <index-term term="Fair Use" subterm="four factors" see="Copyright Act, 107(3)"/>.</para>
  7. <!-- 法律文档索引XSLT -->
  8. <xsl:template name="generate-legal-index">
  9.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  10.     <xsl:sort select="@term"/>
  11.     <fo:block margin-bottom="6pt">
  12.       <fo:inline font-weight="bold" font-style="italic">
  13.         <xsl:value-of select="@term"/>
  14.       </fo:inline>
  15.       <xsl:choose>
  16.         <xsl:when test="@see">
  17.           <xsl:text> see </xsl:text>
  18.           <fo:inline font-style="italic">
  19.             <xsl:value-of select="@see"/>
  20.           </fo:inline>
  21.         </xsl:when>
  22.         <xsl:otherwise>
  23.           <xsl:text>, </xsl:text>
  24.           <xsl:for-each select="key('index-terms', @term)[not(@subterm)]">
  25.             <xsl:value-of select="ancestor::chapter/title"/>
  26.             <xsl:if test="@section">
  27.               <xsl:text> §</xsl:text>
  28.               <xsl:value-of select="@section"/>
  29.             </xsl:if>
  30.             <xsl:if test="position() != last()">, </xsl:if>
  31.           </xsl:for-each>
  32.         </xsl:otherwise>
  33.       </xsl:choose>
  34.     </fo:block>
  35.    
  36.     <!-- 子术语 -->
  37.     <xsl:for-each select="//index-term[@term = current()/@term and @subterm][generate-id() = generate-id(key('subterms', concat(@term, '::', @subterm))[1])]">
  38.       <xsl:sort select="@subterm"/>
  39.       <fo:block margin-left="12pt" margin-bottom="6pt">
  40.         <fo:inline font-style="italic">
  41.           <xsl:value-of select="@subterm"/>
  42.         </fo:inline>
  43.         <xsl:choose>
  44.           <xsl:when test="@see">
  45.             <xsl:text> see </xsl:text>
  46.             <fo:inline font-style="italic">
  47.               <xsl:value-of select="@see"/>
  48.             </fo:inline>
  49.           </xsl:when>
  50.           <xsl:otherwise>
  51.             <xsl:text>, </xsl:text>
  52.             <xsl:for-each select="key('subterms', concat(@term, '::', @subterm))">
  53.               <xsl:value-of select="ancestor::chapter/title"/>
  54.               <xsl:if test="@section">
  55.                 <xsl:text> §</xsl:text>
  56.                 <xsl:value-of select="@section"/>
  57.               </xsl:if>
  58.               <xsl:if test="position() != last()">, </xsl:if>
  59.             </xsl:for-each>
  60.           </xsl:otherwise>
  61.         </xsl:choose>
  62.       </fo:block>
  63.     </xsl:for-each>
  64.   </xsl:for-each>
  65. </xsl:template>
复制代码

学术论文索引

学术论文索引可能需要包括作者、主题和方法等多种索引：
  2. <!-- 示例：学术论文索引条目 -->
  3. <para>As <index-term type="author" name="Smith"/>Smith (2020) argues,
  4. <index-term type="subject" term="qualitative research"/>qualitative research
  5. provides deeper insights into <index-term type="method" term="interviews"/>interviews.</para>
  7. <!-- 学术论文索引XSLT -->
  8. <xsl:key name="author-index" match="index-term[@type='author']" use="@name"/>
  9. <xsl:key name="subject-index" match="index-term[@type='subject']" use="@term"/>
  10. <xsl:key name="method-index" match="index-term[@type='method']" use="@term"/>
  12. <xsl:template name="generate-academic-index">
  13.   <!-- 作者索引 -->
  14.   <fo:block font-size="14pt" font-weight="bold" margin-top="12pt" margin-bottom="8pt">
  15.     Author Index
  16.   </fo:block>
  17.   <xsl:for-each select="//index-term[@type='author'][generate-id() = generate-id(key('author-index', @name)[1])]">
  18.     <xsl:sort select="@name"/>
  19.     <fo:block margin-bottom="4pt">
  20.       <xsl:value-of select="@name"/>
  21.       <xsl:text>, </xsl:text>
  22.       <xsl:for-each select="key('author-index', @name)">
  23.         <xsl:value-of select="ancestor::chapter/title"/>
  24.         <xsl:if test="position() != last()">, </xsl:if>
  25.       </xsl:for-each>
  26.     </fo:block>
  27.   </xsl:for-each>
  28.   
  29.   <!-- 主题索引 -->
  30.   <fo:block font-size="14pt" font-weight="bold" margin-top="12pt" margin-bottom="8pt">
  31.     Subject Index
  32.   </fo:block>
  33.   <xsl:for-each select="//index-term[@type='subject'][generate-id() = generate-id(key('subject-index', @term)[1])]">
  34.     <xsl:sort select="@term"/>
  35.     <fo:block margin-bottom="4pt">
  36.       <xsl:value-of select="@term"/>
  37.       <xsl:text>, </xsl:text>
  38.       <xsl:for-each select="key('subject-index', @term)">
  39.         <xsl:value-of select="ancestor::chapter/title"/>
  40.         <xsl:if test="position() != last()">, </xsl:if>
  41.       </xsl:for-each>
  42.     </fo:block>
  43.   </xsl:for-each>
  44.   
  45.   <!-- 方法索引 -->
  46.   <fo:block font-size="14pt" font-weight="bold" margin-top="12pt" margin-bottom="8pt">
  47.     Method Index
  48.   </fo:block>
  49.   <xsl:for-each select="//index-term[@type='method'][generate-id() = generate-id(key('method-index', @term)[1])]">
  50.     <xsl:sort select="@term"/>
  51.     <fo:block margin-bottom="4pt">
  52.       <xsl:value-of select="@term"/>
  53.       <xsl:text>, </xsl:text>
  54.       <xsl:for-each select="key('method-index', @term)">
  55.         <xsl:value-of select="ancestor::chapter/title"/>
  56.         <xsl:if test="position() != last()">, </xsl:if>
  57.       </xsl:for-each>
  58.     </fo:block>
  59.   </xsl:for-each>
  60. </xsl:template>
复制代码

常见问题和解决方案

问题1：索引条目排序不正确

问题：索引条目没有按字母顺序正确排序，特别是涉及特殊字符或不同语言时。

解决方案：使用适当的排序规则和语言设置：
  2. <xsl:sort select="@term" lang="en" data-type="text" collation="http://www.w3.org/2013/collation/UCA?lang=en"/>
复制代码

问题2：页码引用不准确

问题：索引中的页码与实际内容位置不匹配。

解决方案：确保在最终生成阶段使用正确的页码引用，可能需要两遍处理：
  2. <!-- 第一遍：收集所有索引条目 -->
  3. <xsl:variable name="raw-index">
  4.   <xsl:for-each select="//index-term">
  5.     <entry term="{@term}" page="{generate-id()}"/>
  6.   </xsl:for-each>
  7. </xsl:variable>
  9. <!-- 第二遍：将生成的页码与索引条目匹配 -->
  10. <xsl:template name="generate-index">
  11.   <xsl:for-each select="$raw-index/entry[generate-id() = generate-id(key('index-terms', @term)[1])]">
  12.     <xsl:sort select="@term"/>
  13.     <fo:block margin-bottom="4pt">
  14.       <xsl:value-of select="@term"/>
  15.       <xsl:text>, </xsl:text>
  16.       <xsl:for-each select="key('index-terms', @term)">
  17.         <xsl:variable name="page-id" select="@page"/>
  18.         <xsl:value-of select="id($page-id)/@page-number"/>
  19.         <xsl:if test="position() != last()">, </xsl:if>
  20.       </xsl:for-each>
  21.     </fo:block>
  22.   </xsl:for-each>
  23. </xsl:template>
复制代码

问题3：索引条目重复

问题：同一术语在索引中出现多次，而不是合并为一个条目。

解决方案：确保使用键（key）正确分组相同的术语：
  2. <xsl:key name="index-terms" match="index-term" use="normalize-space(translate(@term, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz'))"/>
  4. <xsl:template name="generate-index">
  5.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', normalize-space(translate(@term, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz')))[1])]">
  6.     <xsl:sort select="normalize-space(translate(@term, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz'))"/>
  7.     <!-- 其余索引生成代码 -->
  8.   </xsl:for-each>
  9. </xsl:template>
复制代码

问题4：索引格式不一致

问题：索引中的术语格式不一致，有些使用大写，有些使用小写。

解决方案：在生成索引时统一术语格式：
  2. <xsl:template name="generate-index">
  3.   <xsl:for-each select="//index-term[generate-id() = generate-id(key('index-terms', @term)[1])]">
  4.     <xsl:sort select="@term"/>
  5.     <fo:block margin-bottom="4pt">
  6.       <!-- 首字母大写，其余小写 -->
  7.       <xsl:value-of select="concat(upper-case(substring(@term, 1, 1)), lower-case(substring(@term, 2)))"/>
  8.       <xsl:text>, </xsl:text>
  9.       <!-- 其余代码 -->
  10.     </fo:block>
  11.   </xsl:for-each>
  12. </xsl:template>
复制代码

问题5：索引生成速度慢

问题：对于大型文档，索引生成过程非常缓慢。

解决方案：优化XSLT代码并使用更高效的处理器：
  2. <!-- 使用XSLT 2.0或更高版本，并优化键的使用 -->
  3. <xsl:stylesheet version="2.0"
  4.   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  5.   xmlns:fo="http://www.w3.org/1999/XSL/Format">
  6.   
  7.   <!-- 使用更高效的键定义 -->
  8.   <xsl:key name="index-terms" match="index-term" use="@term"/>
  9.   
  10.   <!-- 使用xsl:for-each-group而不是generate-id()检查 -->
  11.   <xsl:template name="generate-index">
  12.     <xsl:for-each-group select="//index-term" group-by="@term">
  13.       <xsl:sort select="@term"/>
  14.       <fo:block margin-bottom="4pt">
  15.         <xsl:value-of select="@term"/>
  16.         <xsl:text>, </xsl:text>
  17.         <xsl:value-of select="current-group()/ancestor::chapter/title" separator=", "/>
  18.       </fo:block>
  19.     </xsl:for-each-group>
  20.   </xsl:template>
  21. </xsl:stylesheet>
复制代码

结论和最佳实践

XSL FO提供了创建专业文档索引的强大功能。通过掌握本文介绍的技术和技巧，您可以创建出结构清晰、格式统一、易于使用的专业索引，显著提升文档的信息检索效率和用户体验。

最佳实践总结

1. 规划索引结构：在开始之前，仔细规划索引的结构和层次，确保它符合用户的需求和期望。
2. 使用一致的术语：确保索引中使用一致的术语和格式，避免混淆。
3. 考虑用户需求：从用户的角度思考，他们可能会如何搜索信息，并相应地组织索引。
4. 自动化索引生成：尽可能使用自动化工具生成索引，减少手动工作量和错误。
5. 测试和验证：在最终发布前，彻底测试索引，确保所有条目准确无误且格式一致。
6. 优化性能：对于大型文档，使用适当的优化技术确保索引生成过程高效。
7. 保持更新：随着文档的更新，及时更新索引，确保其始终准确反映文档内容。

规划索引结构：在开始之前，仔细规划索引的结构和层次，确保它符合用户的需求和期望。

使用一致的术语：确保索引中使用一致的术语和格式，避免混淆。

考虑用户需求：从用户的角度思考，他们可能会如何搜索信息，并相应地组织索引。

自动化索引生成：尽可能使用自动化工具生成索引，减少手动工作量和错误。

测试和验证：在最终发布前，彻底测试索引，确保所有条目准确无误且格式一致。

优化性能：对于大型文档，使用适当的优化技术确保索引生成过程高效。

保持更新：随着文档的更新，及时更新索引，确保其始终准确反映文档内容。

通过遵循这些最佳实践，您可以充分利用XSL FO的强大功能，创建出专业、高效、用户友好的文档索引，为读者提供卓越的信息检索体验。
回复

使用道具 举报

返回列表 发新帖
您需要登录后才可以回帖 登录 | 立即注册
高级模式
B Color Image Link Quote Code Smilies

本版积分规则

友情链接

keba
磕巴白菜
别管 别听 就是玩
二次元论坛
二次元论坛
按下F逃离世界！
次元宅社
次元宅社
开放、共创，CHANGE SEKAI！
频道订阅

频道订阅

加入社群

加入社群

联系我们|TG频道|RSS

Powered by Pixtech

© 2025 Pixtech Team.