Python操作PDF书签详解 - 添加、修改、提取和删除

nuclear2011

已于 2025-05-19 15:19:39 修改

阅读量835

点赞数 24

分类专栏： Python PDF 文章标签： python linux 开发语言

于 2025-05-19 14:30:00 首次发布

本文链接：https://blog.csdn.net/nuclear2011/article/details/148012850

版权

Python PDF 专栏收录该内容

16 篇文章

订阅专栏

简介

PDF 书签是 PDF 文件中的导航工具，通常包含一个标题和一个跳转位置（如指定的页面或位置）。它们可以像目录一样分层显示，用户可以展开或折叠这些书签，在文档中快速找到需要的内容。从技术上看，书签是 PDF 文件结构中的大纲对象，不会改变文档内容，只是帮助用户更方便地导航。

本教程将详细介绍如何使用 Python对 PDF 文件中的书签进行操作，包括添加、更新、提取和删除等。

Python 添加、修改、提取和删除PDF书签

使用工具

要在 Python 中操作 PDF 书签，需要一个合适的PDF处理库。本文所使用的库是Spire.PDF for Python，该库支持对 PDF 书签执行多种操作，包括：

添加书签：为文档创建单层或嵌套书签，构建层次化导航。
修改书签：更新书签的标题、目标页面、位置及显示样式。
删除书签：清除不再需要的书签，保持文档整洁。
提取书签：读取并输出文档中现有书签的信息。

安装 Spire.PDF

在开始操作 PDF 书签之前，请确保您的 Python 环境中已安装 Spire.PDF。可以通过以下pip命令进行安装：

pip install spire.pdf

安装完成后，即可在Python项目中导入并调用该库的相关API。

Python 向 PDF 添加书签

添加书签

Spire.PDF提供了PdfDocument.Bookmarks.Add() 方法，用于为PDF文档添加书签。添加时，你可以自定义书签的跳转位置以及颜色和样式等属性。

添加书签的主要步骤

加载 PDF 文档
使用 PdfDocument 类打开已有的 PDF 文件。
添加书签
调用 PdfDocument.Bookmarks.Add() 方法，将书签添加到文档的书签集合中。
设置书签跳转位置
为书签设置目标跳转位置，例如目标页码、具体坐标位置以及缩放比例。
自定义书签（可选）
通过设置书签的属性，如颜色（Color）和显示样式（DisplayStyle），来调整书签文字的颜色和字体样式。
保存修改后的 PDF 文档
使用 PdfDocument.SaveToFile() 方法，将修改后的文档保存到文件。

实现代码

from spire.pdf import *

# 打开 PDF 文件
pdf = PdfDocument("测试.pdf")

# 添加书签
bookmark = pdf.Bookmarks.Add("第一章")

# 设置书签的跳转位置为第一页左上角
bookmark.Destination = PdfDestination(pdf.Pages[0], PointF(0.0, 0.0))

# 自定义书签外观：设置颜色和样式
bookmark.Color = PdfRGBColor(Color.get_Blue())
bookmark.DisplayStyle = PdfTextStyle.Regular

# 保存 PDF 文件
pdf.SaveToFile("添加书签.pdf")
pdf.Close()

添加嵌套书签

在 PDF 中，嵌套书签是一种具有层次结构的书签，允许用户以树状结构导航文档内容。它们类似于目录，其中某些书签可以包含子书签，这些子书签可以进一步包含子级，形成层次关系。

嵌套书签的特点

层次结构：父书签可以包含一个或多个子书签，子书签也可以有自己的子书签。
内容导航：点击嵌套书签可以快速跳转到文档中相应的页面或特定位置。
灵活性：嵌套书签可以指向 PDF 文档中的任何页面或位置。

添加嵌套书签的主要步骤

加载 PDF 文档
使用 PdfDocument 类打开 PDF 文件。
添加父书签
调用 PdfDocument.Bookmarks.Add() 方法，将父书签添加到 PDF 文档的书签集合中。
设置父书签的跳转位置
为父书签指定目标调整位置，例如目标页码、具体坐标和缩放比例。
自定义父书签（可选）
通过属性（如 Color 和 DisplayStyle），自定义书签的外观，包括文本颜色和字体样式。
添加子书签
调用 PdfBookmark.ConvertToBookmarkCollection().Add() 方法，在父书签下添加一个子书签。
设置子书签的跳转位置
为子书签指定目标位置，例如目标页码、具体坐标和缩放比例。
自定义子书签（可选）
使用 Color 和 DisplayStyle 属性，自定义嵌套书签的文本颜色和字体样式。
保存修改后的 PDF 文档
调用 PdfDocument.SaveToFile() 方法，将修改后的 PDF 文档保存到文件中。

实现代码

from spire.pdf import *

# 加载 PDF 文件
pdf = PdfDocument("测试.pdf")

# 添加父书签
parent_bookmark = pdf.Bookmarks.Add("第一章")
parent_bookmark.Destination = PdfDestination(pdf.Pages[0], PointF(0.0, 0.0))

# 添加子书签
child_bookmark = parent_bookmark.ConvertToBookmarkCollection().Add("1.1 简介")
child_bookmark.Destination = PdfDestination(pdf.Pages[0], PointF(0.0, 20.0))

# 保存 PDF 文件
pdf.SaveToFile("添加嵌套书签.pdf")
pdf.Close()

Python 修改 PDF 书签

当 PDF 文档内容发生变化时（如页面顺序更改或章节名称更新），书签也需要相应调整。

修改 PDF 书签的主要步骤

加载 PDF 文档
使用 PdfDocument 类打开包含书签的现有 PDF 文件。
访问目标书签
通过索引定位要更新的书签，例如 PdfDocument.Bookmarks[0] 表示第一个书签。
修改书签属性
使用书签的 Title 属性更改书签标题，并通过属性（如 Color）调整其外观。
保存修改后的 PDF 文档
调用 PdfDocument.SaveToFile() 方法，保存更新后的 PDF 文件。

实现代码

from spire.pdf import *

# 打开 PDF 文件
pdf = PdfDocument("添加书签.pdf")

# 获取第一个书签并更新标题和颜色
bookmark = pdf.Bookmarks[0]
bookmark.Title = "新书签"
bookmark.Color = PdfRGBColor(Color.get_Red())

# 保存 PDF 文件
pdf.SaveToFile("修改书签.pdf")
pdf.Close()

Python 展开或折叠 PDF 书签

在 PDF 文档中，书签可以设置为展开或折叠状态。这种方式可以控制嵌套书签在文档打开时的显示效果。

展开或折叠书签的步骤

实现代码

加载 PDF 文档
使用 PdfDocument 类打开一个包含书签的现有 PDF 文件。
访问目标书签
通过索引定位要更新的书签，例如 PdfDocument.Bookmarks[0] 表示第一个书签。
设置书签的展开或折叠状态
使用书签的 ExpandBookmark 属性控制其显示状态：
设置为 True 表示书签在打开 PDF 时自动展开。
设置为 False 表示书签在打开 PDF 时保持折叠。
保存修改后的 PDF 文档
调用 PdfDocument.SaveToFile() 方法，将更新后的 PDF 文档保存到指定位置。

from spire.pdf import *

# 打开 PDF 文件
pdf = PdfDocument("添加嵌套书签.pdf")

# 获取第一个书签并设置为折叠
bookmark = pdf.Bookmarks[0]
bookmark.ExpandBookmark = False

# 保存 PDF 文件
pdf.SaveToFile("折叠书签.pdf")
pdf.Close()

Python 提取 PDF 书签

从 PDF 文件中提取书签可以帮助您审核文档结构、生成目录或将书签迁移到其他文档中。借助 Spire.PDF，您可以获取所有书签，包括父书签和子书签。

提取 PDF 书签的主要步骤

定义递归函数遍历书签
自定义一个函数，用于遍历 PdfBookmarkCollection 中的书签，打印每个书签的标题和页码，并递归处理嵌套书签。
加载 PDF 文档
使用 PdfDocument 类打开包含书签的现有 PDF 文件。
调用函数以提取书签
将 PDF 文档的书签集合传递给该函数，从文档中提取所有书签信息。

实现代码

from spire.pdf import *

# 打开 PDF 文件
pdf = PdfDocument("添加嵌套书签.pdf")

# 递归函数：提取书签
def extract_bookmarks(bookmarks, level=0):
    for i in range(bookmarks.Count):
        bookmark = bookmarks[i]
        print("  " * level + f"标题: {bookmark.Title}, 页码: {bookmark.Destination.PageNumber + 1}")
        if bookmark.ConvertToBookmarkCollection():
            extract_bookmarks(bookmark.ConvertToBookmarkCollection(), level + 1)

extract_bookmarks(pdf.Bookmarks)
pdf.Close()

Python 删除 PDF 书签

当你不再需要书签导航时，可以从PDF文档中删除书签。Spire.PDF 支持批量删除所有书签，也可以针对性地删除指定书签。

删除 PDF 书签的步骤

加载 PDF 文档
使用 PdfDocument 类打开一个包含书签的现有 PDF 文件。
删除特定书签
使用 PdfDocument.Bookmarks.RemoveAt(index) 方法删除指定的书签。
删除所有书签（可选）
如果希望一次性删除文档中的所有书签，可以使用 PdfDocument.Bookmarks.Clear() 方法.
保存更新后的 PDF 文档
使用 PdfDocument.SaveToFile() 方法保存修改后的文档。

实现代码

from spire.pdf import *

# 打开现有的 PDF 文档
pdf = PdfDocument("添加嵌套书签.pdf")

# 检查是否存在书签，如果存在，删除第一个书签（其子书签会被一并删除）
if pdf.Bookmarks.Count > 0:
    pdf.Bookmarks.RemoveAt(0)

# 可选：删除所有书签
# pdf.Bookmarks.Clear()

# 保存更新后的 PDF
pdf.SaveToFile("删除书签.pdf")
pdf.Close()

以上就是使用Python添加、修改、提取和删除PDF书签的全部内容。感谢阅读！