简体中文 繁體中文 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技术指南轻松创建PDF书签提升文档阅读体验详解实现步骤与常见问题解决方案助你快速掌握这一实用技能让文档更专业

威震华夏关云长

3万

主题

424

科技点

3万

积分

大区版主

木柜子打湿

积分
31917

三倍冰淇淋无人之境【一阶】财Doro小樱（小丑装）立华奏以外的星空【二阶】⑨的冰沙
发表于 2025-9-24 12:40:00 | 显示全部楼层 |阅读模式 [标记阅至此楼]

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

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

x
引言

XSL-FO（XSL Formatting Objects）是一种用于格式化XML数据的W3C标准，它专门设计用于将XML内容转换为高质量的打印文档，特别是PDF文件。在处理长文档时，PDF书签是一项极其重要的功能，它能显著提升文档的导航性和用户体验。本文将详细介绍如何使用XSL-FO技术创建PDF书签，帮助你快速掌握这一实用技能，让你的文档更加专业。

1. XSL-FO基础概述

1.1 什么是XSL-FO

XSL-FO是XSL（Extensible Stylesheet Language）的一部分，专门用于描述XML文档的视觉呈现。它将内容和表现分离，使开发者能够专注于数据的结构和内容，而将格式化交给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.   <fo:page-sequence>
  8.     <!-- 页面内容 -->
  9.   </fo:page-sequence>
  10. </fo:root>
复制代码

1.2 XSL-FO处理器

要将XSL-FO转换为PDF，需要使用XSL-FO处理器。常用的处理器包括：

• Apache FOP（Formatting Objects Processor）：开源且广泛使用的XSL-FO处理器
• RenderX XEP：商业XSL-FO处理器，提供高级功能
• Antenna House Formatter：商业处理器，支持复杂布局

本文将以Apache FOP为例进行讲解，因为它免费且功能强大。

2. PDF书签的重要性

PDF书签（也称为大纲）是PDF文档中的导航元素，它们显示在PDF阅读器的左侧面板中，允许用户快速跳转到文档的特定部分。书签的主要优势包括：

1. 提升导航效率：用户可以快速定位到文档的任何部分
2. 增强文档结构：书签反映了文档的层次结构，使内容组织更加清晰
3. 改善用户体验：专业文档通常包含完整的书签结构，这已成为行业标准
4. 提高文档可用性：特别是对于长文档和参考手册，书签是必不可少的

3. 使用XSL-FO创建PDF书签的基本步骤

3.1 设置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.          xmlns:fox="http://xmlgraphics.apache.org/fop/extensions">
  5.   
  6.   <fo:layout-master-set>
  7.     <!-- 页面布局定义 -->
  8.     <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm">
  9.       <fo:region-body margin="2cm"/>
  10.       <fo:region-before extent="3cm"/>
  11.       <fo:region-after extent="1.5cm"/>
  12.     </fo:simple-page-master>
  13.   </fo:layout-master-set>
  14.   
  15.   <fo:page-sequence master-reference="A4">
  16.     <!-- 页面内容 -->
  17.   </fo:page-sequence>
  18.   
  19. </fo:root>
复制代码

注意，我们添加了xmlns:fox="http://xmlgraphics.apache.org/fop/extensions"命名空间，这是Apache FOP的扩展命名空间，用于创建书签。

3.2 创建基本书签

在XSL-FO中，书签是通过fox:bookmark和fox:bookmark-title元素创建的。以下是一个简单示例：
  2. <fo:page-sequence master-reference="A4">
  3.   <!-- 书签定义 -->
  4.   <fo:bookmark-tree>
  5.     <fox:bookmark internal-destination="intro">
  6.       <fox:bookmark-title>介绍</fox:bookmark-title>
  7.     </fox:bookmark>
  8.     <fox:bookmark internal-destination="chapter1">
  9.       <fox:bookmark-title>第一章</fox:bookmark-title>
  10.     </fox:bookmark>
  11.     <fox:bookmark internal-destination="chapter2">
  12.       <fox:bookmark-title>第二章</fox:bookmark-title>
  13.     </fox:bookmark>
  14.   </fo:bookmark-tree>
  15.   
  16.   <!-- 页面内容 -->
  17.   <fo:flow flow-name="xsl-region-body">
  18.     <fo:block id="intro" font-size="18pt" font-weight="bold" space-after="1cm">
  19.       介绍
  20.     </fo:block>
  21.     <fo:block>
  22.       这是介绍部分的内容...
  23.     </fo:block>
  24.    
  25.     <fo:block id="chapter1" font-size="18pt" font-weight="bold" space-before="2cm" space-after="1cm">
  26.       第一章
  27.     </fo:block>
  28.     <fo:block>
  29.       这是第一章的内容...
  30.     </fo:block>
  31.    
  32.     <fo:block id="chapter2" font-size="18pt" font-weight="bold" space-before="2cm" space-after="1cm">
  33.       第二章
  34.     </fo:block>
  35.     <fo:block>
  36.       这是第二章的内容...
  37.     </fo:block>
  38.   </fo:flow>
  39. </fo:page-sequence>
复制代码

在这个示例中：

• fo:bookmark-tree是书签树的容器
• fox:bookmark定义一个书签项，internal-destination属性指向文档中的一个ID
• fox:bookmark-title定义书签的显示文本
• 每个书签对应的内容块都有一个id属性，与书签的internal-destination相匹配

3.3 创建嵌套书签

对于复杂的文档结构，通常需要创建嵌套的书签层次。以下是一个包含嵌套书签的示例：
  2. <fo:bookmark-tree>
  3.   <fox:bookmark internal-destination="intro">
  4.     <fox:bookmark-title>介绍</fox:bookmark-title>
  5.   </fox:bookmark>
  6.   
  7.   <fox:bookmark internal-destination="chapter1">
  8.     <fox:bookmark-title>第一章 基础概念</fox:bookmark-title>
  9.     <!-- 嵌套书签 -->
  10.     <fox:bookmark internal-destination="section1-1">
  11.       <fox:bookmark-title>1.1 概述</fox:bookmark-title>
  12.     </fox:bookmark>
  13.     <fox:bookmark internal-destination="section1-2">
  14.       <fox:bookmark-title>1.2 基本原理</fox:bookmark-title>
  15.     </fox:bookmark>
  16.   </fox:bookmark>
  17.   
  18.   <fox:bookmark internal-destination="chapter2">
  19.     <fox:bookmark-title>第二章 高级应用</fox:bookmark-title>
  20.     <!-- 嵌套书签 -->
  21.     <fox:bookmark internal-destination="section2-1">
  22.       <fox:bookmark-title>2.1 复杂场景</fox:bookmark-title>
  23.       <!-- 更深层嵌套 -->
  24.       <fox:bookmark internal-destination="subsection2-1-1">
  25.         <fox:bookmark-title>2.1.1 实例分析</fox:bookmark-title>
  26.       </fox:bookmark>
  27.     </fox:bookmark>
  28.     <fox:bookmark internal-destination="section2-2">
  29.       <fox:bookmark-title>2.2 最佳实践</fox:bookmark-title>
  30.     </fox:bookmark>
  31.   </fox:bookmark>
  32. </fo:bookmark-tree>
复制代码

对应的文档内容结构如下：
  2. <fo:flow flow-name="xsl-region-body">
  3.   <fo:block id="intro" font-size="18pt" font-weight="bold" space-after="1cm">
  4.     介绍
  5.   </fo:block>
  6.   
  7.   <fo:block id="chapter1" font-size="18pt" font-weight="bold" space-before="2cm" space-after="1cm">
  8.     第一章 基础概念
  9.   </fo:block>
  10.   
  11.   <fo:block id="section1-1" font-size="16pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  12.     1.1 概述
  13.   </fo:block>
  14.   
  15.   <fo:block id="section1-2" font-size="16pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  16.     1.2 基本原理
  17.   </fo:block>
  18.   
  19.   <fo:block id="chapter2" font-size="18pt" font-weight="bold" space-before="2cm" space-after="1cm">
  20.     第二章 高级应用
  21.   </fo:block>
  22.   
  23.   <fo:block id="section2-1" font-size="16pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  24.     2.1 复杂场景
  25.   </fo:block>
  26.   
  27.   <fo:block id="subsection2-1-1" font-size="14pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  28.     2.1.1 实例分析
  29.   </fo:block>
  30.   
  31.   <fo:block id="section2-2" font-size="16pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  32.     2.2 最佳实践
  33.   </fo:block>
  34. </fo:flow>
复制代码

3.4 使用XSLT自动生成书签

在实际应用中，我们通常使用XSLT转换来自动生成XSL-FO文档，包括书签。以下是一个XSLT样式表的示例，它从XML源文档生成带有书签的XSL-FO：
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <xsl:stylesheet version="1.1"
  4.     xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  5.     xmlns:fo="http://www.w3.org/1999/XSL/Format"
  6.     xmlns:fox="http://xmlgraphics.apache.org/fop/extensions"
  7.     exclude-result-prefixes="fox">
  8.    
  9.   <xsl:template match="/">
  10.     <fo:root>
  11.       <fo:layout-master-set>
  12.         <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm">
  13.           <fo:region-body margin="2cm"/>
  14.           <fo:region-before extent="3cm"/>
  15.           <fo:region-after extent="1.5cm"/>
  16.         </fo:simple-page-master>
  17.       </fo:layout-master-set>
  18.       
  19.       <fo:page-sequence master-reference="A4">
  20.         <!-- 自动生成书签 -->
  21.         <fo:bookmark-tree>
  22.           <xsl:apply-templates select="document/chapter" mode="bookmark"/>
  23.         </fo:bookmark-tree>
  24.         
  25.         <!-- 生成内容 -->
  26.         <fo:flow flow-name="xsl-region-body">
  27.           <xsl:apply-templates select="document/intro"/>
  28.           <xsl:apply-templates select="document/chapter"/>
  29.         </fo:flow>
  30.       </fo:page-sequence>
  31.     </fo:root>
  32.   </xsl:template>
  33.   
  34.   <!-- 书签生成模板 -->
  35.   <xsl:template match="chapter" mode="bookmark">
  36.     <fox:bookmark internal-destination="{generate-id()}">
  37.       <fox:bookmark-title>
  38.         <xsl:value-of select="title"/>
  39.       </fox:bookmark-title>
  40.       <!-- 为每个节生成子书签 -->
  41.       <xsl:apply-templates select="section" mode="bookmark"/>
  42.     </fox:bookmark>
  43.   </xsl:template>
  44.   
  45.   <xsl:template match="section" mode="bookmark">
  46.     <fox:bookmark internal-destination="{generate-id()}">
  47.       <fox:bookmark-title>
  48.         <xsl:value-of select="title"/>
  49.       </fox:bookmark-title>
  50.       <!-- 为每个子节生成子书签 -->
  51.       <xsl:apply-templates select="subsection" mode="bookmark"/>
  52.     </fox:bookmark>
  53.   </xsl:template>
  54.   
  55.   <xsl:template match="subsection" mode="bookmark">
  56.     <fox:bookmark internal-destination="{generate-id()}">
  57.       <fox:bookmark-title>
  58.         <xsl:value-of select="title"/>
  59.       </fox:bookmark-title>
  60.     </fox:bookmark>
  61.   </xsl:template>
  62.   
  63.   <!-- 内容生成模板 -->
  64.   <xsl:template match="intro">
  65.     <fo:block id="{generate-id()}" font-size="18pt" font-weight="bold" space-after="1cm">
  66.       <xsl:value-of select="title"/>
  67.     </fo:block>
  68.     <fo:block>
  69.       <xsl:apply-templates select="para"/>
  70.     </fo:block>
  71.   </xsl:template>
  72.   
  73.   <xsl:template match="chapter">
  74.     <fo:block id="{generate-id()}" font-size="18pt" font-weight="bold" space-before="2cm" space-after="1cm" break-before="page">
  75.       <xsl:value-of select="title"/>
  76.     </fo:block>
  77.     <xsl:apply-templates select="section"/>
  78.   </xsl:template>
  79.   
  80.   <xsl:template match="section">
  81.     <fo:block id="{generate-id()}" font-size="16pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  82.       <xsl:value-of select="title"/>
  83.     </fo:block>
  84.     <fo:block>
  85.       <xsl:apply-templates select="para"/>
  86.     </fo:block>
  87.     <xsl:apply-templates select="subsection"/>
  88.   </xsl:template>
  89.   
  90.   <xsl:template match="subsection">
  91.     <fo:block id="{generate-id()}" font-size="14pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  92.       <xsl:value-of select="title"/>
  93.     </fo:block>
  94.     <fo:block>
  95.       <xsl:apply-templates select="para"/>
  96.     </fo:block>
  97.   </xsl:template>
  98.   
  99.   <xsl:template match="para">
  100.     <fo:block space-after="0.5cm">
  101.       <xsl:apply-templates/>
  102.     </fo:block>
  103.   </xsl:template>
  104. </xsl:stylesheet>
复制代码

对应的XML源文档示例：
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <document>
  4.   <intro>
  5.     <title>介绍</title>
  6.     <para>这是介绍部分的内容...</para>
  7.   </intro>
  8.   
  9.   <chapter>
  10.     <title>第一章 基础概念</title>
  11.     <section>
  12.       <title>1.1 概述</title>
  13.       <para>这是1.1节的内容...</para>
  14.     </section>
  15.     <section>
  16.       <title>1.2 基本原理</title>
  17.       <para>这是1.2节的内容...</para>
  18.     </section>
  19.   </chapter>
  20.   
  21.   <chapter>
  22.     <title>第二章 高级应用</title>
  23.     <section>
  24.       <title>2.1 复杂场景</title>
  25.       <para>这是2.1节的内容...</para>
  26.       <subsection>
  27.         <title>2.1.1 实例分析</title>
  28.         <para>这是2.1.1子节的内容...</para>
  29.       </subsection>
  30.     </section>
  31.     <section>
  32.       <title>2.2 最佳实践</title>
  33.       <para>这是2.2节的内容...</para>
  34.     </section>
  35.   </chapter>
  36. </document>
复制代码

4. 高级书签功能

4.1 设置书签初始状态

你可以设置书签的初始展开或折叠状态，使用starting-state属性：
  2. <fox:bookmark internal-destination="chapter1" starting-state="hide">
  3.   <fox:bookmark-title>第一章</fox:bookmark-title>
  4.   <!-- 子书签 -->
  5. </fox:bookmark>
复制代码

starting-state可以设置为：

• “show”：默认展开
• “hide”：默认折叠

4.2 为书签添加颜色

使用fox:bookmark-color可以为书签添加颜色，增强视觉效果：
  2. <fox:bookmark internal-destination="chapter1">
  3.   <fox:bookmark-title>第一章</fox:bookmark-title>
  4.   <fox:bookmark-color>#FF0000</fox:bookmark-color>
  5.   <!-- 子书签 -->
  6. </fox:bookmark>
复制代码

4.3 设置外部链接书签

书签不仅可以链接到文档内部，还可以链接到外部资源：
  2. <fox:bookmark external-destination="url('https://www.example.com')">
  3.   <fox:bookmark-title>访问示例网站</fox:bookmark-title>
  4. </fox:bookmark>
复制代码

5. 使用Apache FOP生成带书签的PDF

5.1 安装和配置Apache FOP

1. 从Apache FOP官网下载最新版本：https://xmlgraphics.apache.org/fop/download.html
2. 解压下载的文件
3. 设置环境变量FOP_HOME指向FOP安装目录
4. 将FOP的bin目录添加到PATH环境变量

5.2 使用命令行生成PDF

假设我们有一个XSL-FO文件document.fo，可以使用以下命令生成PDF：
  2. fop -fo document.fo -pdf document.pdf
复制代码

如果使用XSLT转换，可以直接从XML和XSL生成PDF：
  2. fop -xml document.xml -xsl stylesheet.xsl -pdf document.pdf
复制代码

5.3 使用Java API生成PDF

在Java应用程序中使用Apache FOP生成PDF的示例代码：
  2. import org.apache.fop.apps.*;
  3. import javax.xml.transform.*;
  4. import javax.xml.transform.sax.SAXResult;
  5. import javax.xml.transform.stream.StreamSource;
  6. import java.io.*;
  8. public class PDFGenerator {
  9.     public static void main(String[] args) {
  10.         try {
  11.             // 配置FOP
  12.             FopFactory fopFactory = FopFactory.newInstance(new File(".").toURI());
  13.             
  14.             // 设置输出流
  15.             OutputStream out = new BufferedOutputStream(new FileOutputStream(new File("document.pdf")));
  16.             
  17.             try {
  18.                 // 构造FOP实例
  19.                 Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, out);
  20.                
  21.                 // 设置XSLT
  22.                 TransformerFactory factory = TransformerFactory.newInstance();
  23.                 Transformer transformer = factory.newTransformer(new StreamSource(new File("stylesheet.xsl")));
  24.                
  25.                 // 设置源和结果
  26.                 Source src = new StreamSource(new File("document.xml"));
  27.                 Result res = new SAXResult(fop.getDefaultHandler());
  28.                
  29.                 // 转换
  30.                 transformer.transform(src, res);
  31.             } finally {
  32.                 out.close();
  33.             }
  34.             
  35.             System.out.println("PDF生成成功!");
  36.         } catch (Exception e) {
  37.             e.printStackTrace(System.err);
  38.         }
  39.     }
  40. }
复制代码

6. 常见问题及解决方案

6.1 书签不显示

问题：生成的PDF中没有书签显示。

可能原因及解决方案：

1. 缺少FOP扩展命名空间：确保在XSL-FO根元素中包含xmlns:fox="http://xmlgraphics.apache.org/fop/extensions"命名空间。
2. 书签定义位置错误：fo:bookmark-tree应该放在fo:page-sequence内部，而不是外部。
3. ID不匹配：检查fox:bookmark的internal-destination属性是否与目标元素的id属性完全匹配。
4. 使用错误的处理器：不是所有XSL-FO处理器都支持FOP的书签扩展。确保使用Apache FOP或兼容的处理器。

6.2 书签顺序错误

问题：书签的顺序与文档中的内容顺序不一致。

解决方案：

• 确保fo:bookmark-tree中书签的顺序与文档中内容的顺序一致
• 如果使用XSLT生成书签，检查XSLT模板的应用顺序
• 考虑使用xsl:sort对书签进行排序：
  2. <xsl:template match="chapter" mode="bookmark">
  3.   <xsl:for-each select=".">
  4.     <xsl:sort select="@order" data-type="number"/>
  5.     <fox:bookmark internal-destination="{generate-id()}">
  6.       <fox:bookmark-title>
  7.         <xsl:value-of select="title"/>
  8.       </fox:bookmark-title>
  9.     </fox:bookmark>
  10.   </xsl:for-each>
  11. </xsl:template>
复制代码

6.3 嵌套书签不工作

问题：嵌套的书签没有正确显示层次结构。

解决方案：

• 确保子书签元素是父书签元素的直接子元素
• 检查XSLT模板是否正确递归应用：
  2. <xsl:template match="chapter" mode="bookmark">
  3.   <fox:bookmark internal-destination="{generate-id()}">
  4.     <fox:bookmark-title>
  5.       <xsl:value-of select="title"/>
  6.     </fox:bookmark-title>
  7.     <!-- 确保这里正确应用了子元素的模板 -->
  8.     <xsl:apply-templates select="section" mode="bookmark"/>
  9.   </fox:bookmark>
  10. </xsl:template>
复制代码

6.4 书签文本显示异常

问题：书签中的文本显示不正确，包含乱码或特殊字符。

解决方案：

• 确保XML和XSL文件使用正确的编码（通常是UTF-8）
• 在XML和XSL文件的开头指定编码：
  2. <?xml version="1.0" encoding="UTF-8"?>
复制代码

• 在XSLT中使用xsl:output指定输出编码：
  2. <xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
复制代码

6.5 书签链接到错误位置

问题：点击书签后，跳转到错误的位置。

解决方案：

• 确保每个目标元素有唯一的ID
• 检查ID是否包含特殊字符，某些特殊字符可能导致链接问题
• 考虑使用generate-id()函数生成唯一ID，避免手动输入错误：
  2. <fo:block id="{generate-id()}">
  3.   <xsl:value-of select="title"/>
  4. </fo:block>
复制代码

6.6 性能问题

问题：处理大型文档时，生成带书签的PDF速度很慢。

解决方案：

• 优化XSLT样式表，减少不必要的模板匹配和处理
• 考虑分页处理大型文档
• 增加Java虚拟机内存：
  2. fop -Xmx2g -fo document.fo -pdf document.pdf
复制代码

7. 最佳实践

7.1 设计一致的书签结构

• 保持书签层次结构与文档结构一致
• 使用一致的命名约定
• 限制书签深度，通常不超过3-4层，以保持导航的简洁性

7.2 使用有意义的书签标题

• 确保书签标题简洁明了
• 包含章节编号，便于用户定位
• 避免过长的书签标题，考虑在必要时使用缩写

7.3 自动化书签生成

• 使用XSLT自动生成书签，而不是手动创建
• 将书签生成逻辑与内容生成逻辑分离
• 使用模板匹配和递归处理复杂的文档结构

7.4 测试和验证

• 在不同的PDF阅读器中测试书签功能
• 验证所有书签链接是否正确
• 检查书签在不同缩放级别下的显示效果

8. 完整示例

以下是一个完整的示例，展示如何从XML源文档生成带有完整书签结构的PDF文档。

8.1 XML源文档 (manual.xml)
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <manual>
  4.   <title>产品使用手册</title>
  5.   
  6.   <front>
  7.     <chapter>
  8.       <title>前言</title>
  9.       <section>
  10.         <title>关于本手册</title>
  11.         <para>本手册提供了产品的详细使用说明...</para>
  12.       </section>
  13.       <section>
  14.         <title>适用范围</title>
  15.         <para>本手册适用于产品的所有版本...</para>
  16.       </section>
  17.     </chapter>
  18.   </front>
  19.   
  20.   <body>
  21.     <chapter id="ch1">
  22.       <title>第一章 产品概述</title>
  23.       <section id="ch1-sec1">
  24.         <title>1.1 产品简介</title>
  25.         <para>我们的产品是一款创新的解决方案...</para>
  26.       </section>
  27.       <section id="ch1-sec2">
  28.         <title>1.2 主要功能</title>
  29.         <para>产品提供以下主要功能...</para>
  30.       </section>
  31.       <section id="ch1-sec3">
  32.         <title>1.3 系统要求</title>
  33.         <para>使用本产品需要满足以下系统要求...</para>
  34.       </section>
  35.     </chapter>
  36.    
  37.     <chapter id="ch2">
  38.       <title>第二章 安装与配置</title>
  39.       <section id="ch2-sec1">
  40.         <title>2.1 安装步骤</title>
  41.         <subsection id="ch2-sec1-sub1">
  42.           <title>2.1.1 Windows系统安装</title>
  43.           <para>在Windows系统上安装产品的步骤...</para>
  44.         </subsection>
  45.         <subsection id="ch2-sec1-sub2">
  46.           <title>2.1.2 Linux系统安装</title>
  47.           <para>在Linux系统上安装产品的步骤...</para>
  48.         </subsection>
  49.       </section>
  50.       <section id="ch2-sec2">
  51.         <title>2.2 基本配置</title>
  52.         <para>安装完成后，需要进行基本配置...</para>
  53.       </section>
  54.     </chapter>
  55.    
  56.     <chapter id="ch3">
  57.       <title>第三章 使用指南</title>
  58.       <section id="ch3-sec1">
  59.         <title>3.1 基本操作</title>
  60.         <para>产品的基本操作包括...</para>
  61.       </section>
  62.       <section id="ch3-sec2">
  63.         <title>3.2 高级功能</title>
  64.         <subsection id="ch3-sec2-sub1">
  65.           <title>3.2.1 数据导入导出</title>
  66.           <para>产品的数据导入导出功能...</para>
  67.         </subsection>
  68.         <subsection id="ch3-sec2-sub2">
  69.           <title>3.2.2 自动化处理</title>
  70.           <para>产品的自动化处理功能...</para>
  71.         </subsection>
  72.       </section>
  73.     </chapter>
  74.   </body>
  75.   
  76.   <appendix>
  77.     <chapter>
  78.       <title>附录</title>
  79.       <section>
  80.         <title>常见问题解答</title>
  81.         <para>以下是用户常见的问题及解答...</para>
  82.       </section>
  83.       <section>
  84.         <title>技术支持</title>
  85.         <para>如需技术支持，请联系...</para>
  86.       </section>
  87.     </chapter>
  88.   </appendix>
  89. </manual>
复制代码

8.2 XSLT样式表 (manual2fo.xsl)
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <xsl:stylesheet version="1.1"
  4.     xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  5.     xmlns:fo="http://www.w3.org/1999/XSL/Format"
  6.     xmlns:fox="http://xmlgraphics.apache.org/fop/extensions"
  7.     exclude-result-prefixes="fox">
  8.    
  9.   <xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
  10.   
  11.   <xsl:template match="/">
  12.     <fo:root>
  13.       <fo:layout-master-set>
  14.         <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm">
  15.           <fo:region-body margin="2cm"/>
  16.           <fo:region-before extent="3cm"/>
  17.           <fo:region-after extent="1.5cm"/>
  18.         </fo:simple-page-master>
  19.       </fo:layout-master-set>
  20.       
  21.       <fo:page-sequence master-reference="A4">
  22.         <!-- 书签树 -->
  23.         <fo:bookmark-tree>
  24.           <!-- 前言部分书签 -->
  25.           <xsl:apply-templates select="manual/front/chapter" mode="bookmark"/>
  26.          
  27.           <!-- 正文部分书签 -->
  28.           <xsl:apply-templates select="manual/body/chapter" mode="bookmark"/>
  29.          
  30.           <!-- 附录部分书签 -->
  31.           <xsl:apply-templates select="manual/appendix/chapter" mode="bookmark"/>
  32.         </fo:bookmark-tree>
  33.         
  34.         <!-- 文档内容 -->
  35.         <fo:flow flow-name="xsl-region-body">
  36.           <!-- 标题页 -->
  37.           <fo:block text-align="center" space-after="2cm">
  38.             <fo:block font-size="24pt" font-weight="bold" space-after="1cm">
  39.               <xsl:value-of select="manual/title"/>
  40.             </fo:block>
  41.             <fo:block font-size="12pt">
  42.               版本 1.0
  43.             </fo:block>
  44.             <fo:block font-size="12pt">
  45.               <xsl:value-of select="format-date(current-date(), '[Y]-[M]-[D]')"/>
  46.             </fo:block>
  47.           </fo:block>
  48.          
  49.           <!-- 前言部分内容 -->
  50.           <xsl:apply-templates select="manual/front/chapter"/>
  51.          
  52.           <!-- 正文部分内容 -->
  53.           <xsl:apply-templates select="manual/body/chapter"/>
  54.          
  55.           <!-- 附录部分内容 -->
  56.           <xsl:apply-templates select="manual/appendix/chapter"/>
  57.         </fo:flow>
  58.       </fo:page-sequence>
  59.     </fo:root>
  60.   </xsl:template>
  61.   
  62.   <!-- 书签生成模板 -->
  63.   <xsl:template match="chapter" mode="bookmark">
  64.     <fox:bookmark internal-destination="{@id}">
  65.       <fox:bookmark-title>
  66.         <xsl:value-of select="title"/>
  67.       </fox:bookmark-title>
  68.       <xsl:apply-templates select="section" mode="bookmark"/>
  69.     </fox:bookmark>
  70.   </xsl:template>
  71.   
  72.   <xsl:template match="section" mode="bookmark">
  73.     <fox:bookmark internal-destination="{@id}">
  74.       <fox:bookmark-title>
  75.         <xsl:value-of select="title"/>
  76.       </fox:bookmark-title>
  77.       <xsl:apply-templates select="subsection" mode="bookmark"/>
  78.     </fox:bookmark>
  79.   </xsl:template>
  80.   
  81.   <xsl:template match="subsection" mode="bookmark">
  82.     <fox:bookmark internal-destination="{@id}">
  83.       <fox:bookmark-title>
  84.         <xsl:value-of select="title"/>
  85.       </fox:bookmark-title>
  86.     </fox:bookmark>
  87.   </xsl:template>
  88.   
  89.   <!-- 内容生成模板 -->
  90.   <xsl:template match="chapter">
  91.     <fo:block id="{@id}" font-size="18pt" font-weight="bold" space-before="2cm" space-after="1cm" break-before="page">
  92.       <xsl:value-of select="title"/>
  93.     </fo:block>
  94.     <xsl:apply-templates select="section"/>
  95.   </xsl:template>
  96.   
  97.   <xsl:template match="section">
  98.     <fo:block id="{@id}" font-size="16pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  99.       <xsl:value-of select="title"/>
  100.     </fo:block>
  101.     <fo:block>
  102.       <xsl:apply-templates select="para"/>
  103.     </fo:block>
  104.     <xsl:apply-templates select="subsection"/>
  105.   </xsl:template>
  106.   
  107.   <xsl:template match="subsection">
  108.     <fo:block id="{@id}" font-size="14pt" font-weight="bold" space-before="1cm" space-after="0.5cm">
  109.       <xsl:value-of select="title"/>
  110.     </fo:block>
  111.     <fo:block>
  112.       <xsl:apply-templates select="para"/>
  113.     </fo:block>
  114.   </xsl:template>
  115.   
  116.   <xsl:template match="para">
  117.     <fo:block space-after="0.5cm" text-align="justify">
  118.       <xsl:apply-templates/>
  119.     </fo:block>
  120.   </xsl:template>
  121. </xsl:stylesheet>
复制代码

8.3 生成PDF的命令

使用Apache FOP生成PDF的命令：
  2. fop -xml manual.xml -xsl manual2fo.xsl -pdf manual.pdf
复制代码

9. 结论

XSL-FO技术为创建专业PDF文档提供了强大的功能，特别是通过书签增强文档导航性。本文详细介绍了如何使用XSL-FO创建PDF书签，包括基本概念、实现步骤、高级功能和常见问题解决方案。

通过掌握这些技术，你可以创建具有专业书签结构的PDF文档，显著提升用户体验。无论是技术手册、产品文档还是学术报告，良好的书签结构都能使文档更加专业和易用。

随着实践的深入，你将能够更加灵活地运用XSL-FO技术，创建出更加复杂和精美的PDF文档，满足各种专业需求。
回复

使用道具 举报

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

本版积分规则

友情链接

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

频道订阅

加入社群

加入社群

联系我们|TG频道|RSS

Powered by Pixtech

© 2025 Pixtech Team.