在处理长篇 PDF 文档时书签Bookmark是帮助读者快速定位到特定章节的关键导航工具。无论是技术手册、学术论文还是企业报告合理的书签结构都能显著提升文档的可读性和使用效率。本文将介绍如何使用 Python 对 PDF 文档中的书签进行完整管理包括创建、修改、删除、获取信息以及控制展开状态等操作。为什么需要编程管理 PDF 书签手动在 PDF 阅读器中添加书签效率较低尤其在面对批量文档或需要频繁更新的场景时更是如此。通过编程方式管理书签具有以下优势批量处理一次脚本运行即可为大量文档生成统一的书签结构精确控制可以准确指定书签跳转位置、样式和层级关系动态更新根据文档内容变化自动调整书签标题和结构自动化集成将书签生成嵌入到文档生成流水线中环境搭建本文使用 Spire.PDF for Python 库来操作 PDF 文档。通过 pip 安装即可bash代码解读复制代码pip install Spire.PDF安装完成后在脚本中导入所需模块python代码解读复制代码from spire.pdf.common import * from spire.pdf import *创建带有父子层级的书签书签的核心概念是层级结构。一个 PDF 文档可以包含多个顶级书签父书签每个父书签下又可以挂载多个子书签形成树状导航。创建书签的关键步骤是创建文档和页面、在页面上绘制内容、然后将书签指向对应的位置。python代码解读复制代码from spire.pdf.common import * from spire.pdf import * doc PdfDocument() # 设置页面边距和尺寸 unitCvtr PdfUnitConvertor() margin PdfMargins() margin.Top unitCvtr.ConvertUnits(2.54, PdfGraphicsUnit.Centimeter, PdfGraphicsUnit.Point) margin.Bottom margin.Top margin.Left unitCvtr.ConvertUnits(3.17, PdfGraphicsUnit.Centimeter, PdfGraphicsUnit.Point) margin.Right margin.Left section doc.Sections.Add() section.PageSettings.Margins margin section.PageSettings.Size PdfPageSize.A4() # 创建第一页并绘制标题 page section.Pages.Add() font_title PdfTrueTypeFont(Arial, 16.0, PdfFontStyle.Bold, True) brush PdfBrushes.get_Black() format_center PdfStringFormat(PdfTextAlignment.Center) page.Canvas.DrawString(PDF 书签示例文档, font_title, brush, page.Canvas.ClientSize.Width / 2, 10, format_center)上述代码完成了文档的基本框架搭建。PdfUnitConvertor用于将厘米等单位转换为 PDF 内部使用的 Point 单位确保页面布局的精确控制。添加父书签父书签通过doc.Bookmarks.Add()方法创建该方法接受书签标题作为参数返回一个PdfBookmark对象。每个书签需要关联一个PdfDestination指定点击书签后跳转到的页面和位置。python代码解读复制代码# 在页面上绘制章节标题 font_chapter PdfTrueTypeFont(Arial, 11.0, PdfFontStyle.Bold, True) y 60.0 page.Canvas.DrawString(1. 第一章 概述, font_chapter, PdfBrushes.get_Blue(), 0.0, y) # 创建父书签并设置跳转目标 dest1 PdfDestination(page, PointF(0.0, y)) bookmark1 doc.Bookmarks.Add(1. 第一章 概述) bookmark1.Color PdfRGBColor(Color.get_SaddleBrown()) bookmark1.DisplayStyle PdfTextStyle.Bold bookmark1.Action PdfGoToAction(dest1)PdfDestination接收页面对象和坐标点作为参数。PdfGoToAction将这个目标绑定到书签上实现点击跳转。书签的Color和DisplayStyle属性分别控制书签在阅读器中显示的颜色和文字样式粗体、斜体等。添加子书签子书签的创建方式与父书签类似区别在于需要通过PdfBookmarkCollection将子书签添加到父书签之下而不是直接添加到文档的顶级书签集合。python代码解读复制代码# 获取父书签的子书签集合 childCollection PdfBookmarkCollection(bookmark1) # 创建子书签 page2 section.Pages.Add() y2 0.0 page2.Canvas.DrawString(1.1. 背景介绍, font_chapter, PdfBrushes.get_Brown(), 0.0, y2) dest_child PdfDestination(page2, PointF(0.0, y2)) child_bookmark childCollection.Add(1.1. 背景介绍) child_bookmark.Color PdfRGBColor(Color.get_Coral()) child_bookmark.DisplayStyle PdfTextStyle.Italic child_bookmark.Action PdfGoToAction(dest_child)通过PdfBookmarkCollection(parentBookmark)获取父书签的子集合后调用Add()方法即可在该父书签下添加子书签。子书签同样可以设置独立的颜色和样式便于在导航面板中区分层级。保存文档完成所有书签的添加后保存文档python代码解读复制代码doc.SaveToFile(Bookmark_output.pdf) doc.Close()修改已有书签对于已存在的 PDF 文档可以加载后修改其书签的标题、颜色和样式。这对于需要根据模板生成定制化文档的场景非常实用。python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 获取第一个顶级书签 bookmark doc.Bookmarks[0] # 修改标题 bookmark.Title 修改后的书签标题 # 修改颜色为黑色 bookmark.Color PdfRGBColor(Color.get_Black()) # 设置样式为粗体 bookmark.DisplayStyle PdfTextStyle.Bold doc.SaveToFile(UpdatedBookmark.pdf) doc.Close()修改子书签时需要通过递归方式遍历子书签集合python代码解读复制代码def update_child_bookmarks(parent_bookmark): children PdfBookmarkCollection(parent_bookmark) for i in range(children.Count): child children.get_Item(i) child.Color PdfRGBColor(Color.get_Blue()) child.DisplayStyle PdfTextStyle.Regular # 递归处理更深层级的子书签 update_child_bookmarks(child) # 更新第一个书签下的所有子书签 update_child_bookmarks(doc.Bookmarks[0])递归遍历确保了无论书签层级有多深每个子书签都能被正确更新。删除书签删除书签分为两种场景删除指定书签和清除所有书签。删除单个书签通过索引移除特定的顶级书签python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 删除第一个顶级书签及其所有子书签 doc.Bookmarks.RemoveAt(0) doc.SaveToFile(DeleteBookmark.pdf) doc.Close()RemoveAt()方法会同时删除该书签下的所有子书签。这在需要精简文档导航结构时非常有用。清除所有书签如果需要一次性移除文档中的所有书签python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 清除所有书签 doc.Bookmarks.Clear() doc.SaveToFile(DeleteAllBookmarks.pdf) doc.Close()Clear()方法会清空整个书签集合适用于需要重新生成书签结构前的清理操作。获取书签信息在自动化处理流程中经常需要读取 PDF 文档中已有的书签信息例如标题、样式和所在页码。获取书签标题和样式python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) bookmarks doc.Bookmarks results [] if bookmarks.Count 0: results.append(PDF 书签列表) for i in range(bookmarks.Count): parent bookmarks.get_Item(i) results.append(f标题{parent.Title}) results.append(f样式{parent.DisplayStyle}) # 递归获取子书签 children PdfBookmarkCollection(parent) for j in range(children.Count): child children.get_Item(j) results.append(f 子书签{child.Title}) results.append(f 样式{child.DisplayStyle}) with open(Bookmarks_Info.txt, w, encodingutf-8) as f: f.write(\n.join(results)) doc.Close()获取书签所在页码书签跳转的目标页码可以通过Destination.Page属性获取。由于Pages.IndexOf()返回的是从 0 开始的索引需要加 1 才是实际的页码编号python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) bookmark doc.Bookmarks[0] page_number doc.Pages.IndexOf(bookmark.Destination.Page) 1 print(f书签所在页码{page_number}) doc.Close()控制书签的展开和折叠状态PDF 阅读器打开文档时书签面板可以处于展开或折叠状态。通过编程方式可以控制这一行为展开或折叠所有书签python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # True 表示展开所有书签False 表示折叠 doc.ViewerPreferences.BookMarkExpandOrCollapse True doc.SaveToFile(ExpandAllBookmarks.pdf) doc.Close()控制特定书签的展开状态如果只需要展开或折叠部分书签可以单独设置每个书签的ExpandBookmark属性python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 展开第一个书签 doc.Bookmarks.get_Item(0).ExpandBookmark True # 折叠第二个书签 doc.Bookmarks.get_Item(1).ExpandBookmark False doc.SaveToFile(ExpandSpecificBookmarks.pdf) doc.Close()这种细粒度的控制适合在文档中突出显示某些重点章节的导航结构同时保持其他章节的折叠状态以减少视觉干扰。设置书签跳转时的缩放级别书签跳转时可以同时控制页面的缩放比例这在需要精确展示页面内容的场景中很有用python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) bookmarks doc.Bookmarks for i in range(bookmarks.Count): bookmark bookmarks.get_Item(i) # 设置缩放级别0.5 表示 50% 缩放 bookmark.Destination.Zoom 0.5 doc.SaveToFile(SetBookmarkZoom.pdf) doc.Close()缩放值为 0 时表示继承当前阅读器的缩放设置大于 0 的值则指定具体的缩放比例。总结本文介绍了使用 Python 管理 PDF 文档书签的完整流程涵盖了以下核心操作创建书签通过Bookmarks.Add()添加父书签通过PdfBookmarkCollection添加子书签修改书签更新标题、颜色和文字样式支持递归修改子书签删除书签使用RemoveAt()删除指定书签使用Clear()清除全部书签获取信息读取书签标题、样式和所在页码控制展开状态全局或单独控制书签的展开和折叠行为设置缩放级别控制书签跳转时的页面缩放比例这些操作可以灵活组合应用于批量文档处理、自动化报告生成等实际场景。掌握书签管理后还可以进一步探索 PDF 的超链接、表单字段和数字签名等高级功能。
使用 Python 在 PDF 中创建与管理书签
在处理长篇 PDF 文档时书签Bookmark是帮助读者快速定位到特定章节的关键导航工具。无论是技术手册、学术论文还是企业报告合理的书签结构都能显著提升文档的可读性和使用效率。本文将介绍如何使用 Python 对 PDF 文档中的书签进行完整管理包括创建、修改、删除、获取信息以及控制展开状态等操作。为什么需要编程管理 PDF 书签手动在 PDF 阅读器中添加书签效率较低尤其在面对批量文档或需要频繁更新的场景时更是如此。通过编程方式管理书签具有以下优势批量处理一次脚本运行即可为大量文档生成统一的书签结构精确控制可以准确指定书签跳转位置、样式和层级关系动态更新根据文档内容变化自动调整书签标题和结构自动化集成将书签生成嵌入到文档生成流水线中环境搭建本文使用 Spire.PDF for Python 库来操作 PDF 文档。通过 pip 安装即可bash代码解读复制代码pip install Spire.PDF安装完成后在脚本中导入所需模块python代码解读复制代码from spire.pdf.common import * from spire.pdf import *创建带有父子层级的书签书签的核心概念是层级结构。一个 PDF 文档可以包含多个顶级书签父书签每个父书签下又可以挂载多个子书签形成树状导航。创建书签的关键步骤是创建文档和页面、在页面上绘制内容、然后将书签指向对应的位置。python代码解读复制代码from spire.pdf.common import * from spire.pdf import * doc PdfDocument() # 设置页面边距和尺寸 unitCvtr PdfUnitConvertor() margin PdfMargins() margin.Top unitCvtr.ConvertUnits(2.54, PdfGraphicsUnit.Centimeter, PdfGraphicsUnit.Point) margin.Bottom margin.Top margin.Left unitCvtr.ConvertUnits(3.17, PdfGraphicsUnit.Centimeter, PdfGraphicsUnit.Point) margin.Right margin.Left section doc.Sections.Add() section.PageSettings.Margins margin section.PageSettings.Size PdfPageSize.A4() # 创建第一页并绘制标题 page section.Pages.Add() font_title PdfTrueTypeFont(Arial, 16.0, PdfFontStyle.Bold, True) brush PdfBrushes.get_Black() format_center PdfStringFormat(PdfTextAlignment.Center) page.Canvas.DrawString(PDF 书签示例文档, font_title, brush, page.Canvas.ClientSize.Width / 2, 10, format_center)上述代码完成了文档的基本框架搭建。PdfUnitConvertor用于将厘米等单位转换为 PDF 内部使用的 Point 单位确保页面布局的精确控制。添加父书签父书签通过doc.Bookmarks.Add()方法创建该方法接受书签标题作为参数返回一个PdfBookmark对象。每个书签需要关联一个PdfDestination指定点击书签后跳转到的页面和位置。python代码解读复制代码# 在页面上绘制章节标题 font_chapter PdfTrueTypeFont(Arial, 11.0, PdfFontStyle.Bold, True) y 60.0 page.Canvas.DrawString(1. 第一章 概述, font_chapter, PdfBrushes.get_Blue(), 0.0, y) # 创建父书签并设置跳转目标 dest1 PdfDestination(page, PointF(0.0, y)) bookmark1 doc.Bookmarks.Add(1. 第一章 概述) bookmark1.Color PdfRGBColor(Color.get_SaddleBrown()) bookmark1.DisplayStyle PdfTextStyle.Bold bookmark1.Action PdfGoToAction(dest1)PdfDestination接收页面对象和坐标点作为参数。PdfGoToAction将这个目标绑定到书签上实现点击跳转。书签的Color和DisplayStyle属性分别控制书签在阅读器中显示的颜色和文字样式粗体、斜体等。添加子书签子书签的创建方式与父书签类似区别在于需要通过PdfBookmarkCollection将子书签添加到父书签之下而不是直接添加到文档的顶级书签集合。python代码解读复制代码# 获取父书签的子书签集合 childCollection PdfBookmarkCollection(bookmark1) # 创建子书签 page2 section.Pages.Add() y2 0.0 page2.Canvas.DrawString(1.1. 背景介绍, font_chapter, PdfBrushes.get_Brown(), 0.0, y2) dest_child PdfDestination(page2, PointF(0.0, y2)) child_bookmark childCollection.Add(1.1. 背景介绍) child_bookmark.Color PdfRGBColor(Color.get_Coral()) child_bookmark.DisplayStyle PdfTextStyle.Italic child_bookmark.Action PdfGoToAction(dest_child)通过PdfBookmarkCollection(parentBookmark)获取父书签的子集合后调用Add()方法即可在该父书签下添加子书签。子书签同样可以设置独立的颜色和样式便于在导航面板中区分层级。保存文档完成所有书签的添加后保存文档python代码解读复制代码doc.SaveToFile(Bookmark_output.pdf) doc.Close()修改已有书签对于已存在的 PDF 文档可以加载后修改其书签的标题、颜色和样式。这对于需要根据模板生成定制化文档的场景非常实用。python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 获取第一个顶级书签 bookmark doc.Bookmarks[0] # 修改标题 bookmark.Title 修改后的书签标题 # 修改颜色为黑色 bookmark.Color PdfRGBColor(Color.get_Black()) # 设置样式为粗体 bookmark.DisplayStyle PdfTextStyle.Bold doc.SaveToFile(UpdatedBookmark.pdf) doc.Close()修改子书签时需要通过递归方式遍历子书签集合python代码解读复制代码def update_child_bookmarks(parent_bookmark): children PdfBookmarkCollection(parent_bookmark) for i in range(children.Count): child children.get_Item(i) child.Color PdfRGBColor(Color.get_Blue()) child.DisplayStyle PdfTextStyle.Regular # 递归处理更深层级的子书签 update_child_bookmarks(child) # 更新第一个书签下的所有子书签 update_child_bookmarks(doc.Bookmarks[0])递归遍历确保了无论书签层级有多深每个子书签都能被正确更新。删除书签删除书签分为两种场景删除指定书签和清除所有书签。删除单个书签通过索引移除特定的顶级书签python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 删除第一个顶级书签及其所有子书签 doc.Bookmarks.RemoveAt(0) doc.SaveToFile(DeleteBookmark.pdf) doc.Close()RemoveAt()方法会同时删除该书签下的所有子书签。这在需要精简文档导航结构时非常有用。清除所有书签如果需要一次性移除文档中的所有书签python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 清除所有书签 doc.Bookmarks.Clear() doc.SaveToFile(DeleteAllBookmarks.pdf) doc.Close()Clear()方法会清空整个书签集合适用于需要重新生成书签结构前的清理操作。获取书签信息在自动化处理流程中经常需要读取 PDF 文档中已有的书签信息例如标题、样式和所在页码。获取书签标题和样式python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) bookmarks doc.Bookmarks results [] if bookmarks.Count 0: results.append(PDF 书签列表) for i in range(bookmarks.Count): parent bookmarks.get_Item(i) results.append(f标题{parent.Title}) results.append(f样式{parent.DisplayStyle}) # 递归获取子书签 children PdfBookmarkCollection(parent) for j in range(children.Count): child children.get_Item(j) results.append(f 子书签{child.Title}) results.append(f 样式{child.DisplayStyle}) with open(Bookmarks_Info.txt, w, encodingutf-8) as f: f.write(\n.join(results)) doc.Close()获取书签所在页码书签跳转的目标页码可以通过Destination.Page属性获取。由于Pages.IndexOf()返回的是从 0 开始的索引需要加 1 才是实际的页码编号python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) bookmark doc.Bookmarks[0] page_number doc.Pages.IndexOf(bookmark.Destination.Page) 1 print(f书签所在页码{page_number}) doc.Close()控制书签的展开和折叠状态PDF 阅读器打开文档时书签面板可以处于展开或折叠状态。通过编程方式可以控制这一行为展开或折叠所有书签python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # True 表示展开所有书签False 表示折叠 doc.ViewerPreferences.BookMarkExpandOrCollapse True doc.SaveToFile(ExpandAllBookmarks.pdf) doc.Close()控制特定书签的展开状态如果只需要展开或折叠部分书签可以单独设置每个书签的ExpandBookmark属性python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) # 展开第一个书签 doc.Bookmarks.get_Item(0).ExpandBookmark True # 折叠第二个书签 doc.Bookmarks.get_Item(1).ExpandBookmark False doc.SaveToFile(ExpandSpecificBookmarks.pdf) doc.Close()这种细粒度的控制适合在文档中突出显示某些重点章节的导航结构同时保持其他章节的折叠状态以减少视觉干扰。设置书签跳转时的缩放级别书签跳转时可以同时控制页面的缩放比例这在需要精确展示页面内容的场景中很有用python代码解读复制代码doc PdfDocument() doc.LoadFromFile(input.pdf) bookmarks doc.Bookmarks for i in range(bookmarks.Count): bookmark bookmarks.get_Item(i) # 设置缩放级别0.5 表示 50% 缩放 bookmark.Destination.Zoom 0.5 doc.SaveToFile(SetBookmarkZoom.pdf) doc.Close()缩放值为 0 时表示继承当前阅读器的缩放设置大于 0 的值则指定具体的缩放比例。总结本文介绍了使用 Python 管理 PDF 文档书签的完整流程涵盖了以下核心操作创建书签通过Bookmarks.Add()添加父书签通过PdfBookmarkCollection添加子书签修改书签更新标题、颜色和文字样式支持递归修改子书签删除书签使用RemoveAt()删除指定书签使用Clear()清除全部书签获取信息读取书签标题、样式和所在页码控制展开状态全局或单独控制书签的展开和折叠行为设置缩放级别控制书签跳转时的页面缩放比例这些操作可以灵活组合应用于批量文档处理、自动化报告生成等实际场景。掌握书签管理后还可以进一步探索 PDF 的超链接、表单字段和数字签名等高级功能。
