Python对PDF书签进行添加,修改提取和删除操作

简介

PDF 书签是 PDF 文件中的导航工具，通常包含一个标题和一个跳转位置（如指定的页面或位置）。它们可以像目录一样分层显示，用户可以展开或折叠这些书签，在文档中快速找到需要的内容。从技术上看，书签是 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 = PdfTextStphpyle.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 文件。

实现代码

frompython 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 文档中，书签可以设置为展开或折叠状态。这种方式可以控制嵌套书签在文档打开时的显示效果。

展开或折叠书签的步骤

1.加载 PDF 文档：使用 PdfDocument 类打开一个包含书签的现有 PDF 文件。

2.访问目标书签：通过索引定位要更新的书签，例如 PdfDocument.Bookmarks[0] 表示第一个书签。

3.设置书签的展开或折叠状态：

• 使用书签的 ExpandBookmark 属性控制其显示状态：
• 设置为 True 表示书签在打开 PDF 时自动展开。
• 设置为 False 表示书签在打开 PDF 时保持折叠。

4.保存修改后的 PDF 文档：调用 PdfDocument.SaveToFile() 方法，将更新后的 PDF 文档保存到指定位置。

实现代码

from spire.pdf import *
 
# 打开 PDF 文件
pdf = PdfDocument("添加嵌套书签.pdf")
 
# android获取第一个书签并设置为折叠
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)
 
jsextract_bookmarks(pdf.Bookmarks)
pdf.Close()

Python 删除 PDF 书签

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

删除 PDF 书签的步骤

• 加载 PDF 文档：使用 PdfDocument 类打开一个包含书签的现有 PDF 文件。
• 删除特定书签：使用 PdfDocument.Bookmarks.RemoveAt(index) javascript方法删除指定的书签。
• 删除所有书签（可选）：如果希望一次性删除文档中的所有书签，可以使用 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书签进行添加,修改提取和删除操作的文章就介绍到这了,更多相关Python操作PDF书签内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)！