IRONSOFTWAREHOME
USING IRONPDF FOR PYTHON

如何使用 Python 向 PDF 添加页码

Curtis Chau
Curtis Chau
Updated: 2026年6月20日

在不断发展的数字文档领域,PDF已成为共享数据、存储和展示书面信息的基础格式。 然而,随着对PDF的依赖持续增长,开发人员经常会遇到多个需要以编程方式操控这些文件的场景。 其中一个常见的需求是在所有页面上添加页码,这是文件导航和组织的重要元素。 在这本综合指南的第一页,我们将深入探讨使用IronPDF向PDF添加页码的细节。

了解IronPDF

IronPDF作为一个强大的Python库的例子,它简化了与编程方式处理PDF文件相关的复杂性。 其广泛的功能集使其成为开发人员无缝操控Python PDFs的多功能工具。 在本教程中,我们的主要重点将是利用IronPDF的功能以页码、字体和图像增强现有的PDF。

有关更多信息和文档,请参考Python IronPDF页面。

前提条件

在开启为现有PDF和文件添加页码的旅程之前,确保已安装IronPDF库是至关重要的。 这可以通过执行下面的命令行来实现。

> pip install ironpdf

实例化渲染器

ChromePdfRenderer类是IronPDF的一个关键组件,便于将HTML和CSS渲染为PDF文件。在我们的脚本中,我们实例化这个新的PDF渲染函数,以准备后续步骤。

# Import IronPDF module
from ironpdf import ChromePdfRenderer

# Instantiate the PDF renderer
renderer = ChromePdfRenderer()
Python

加载PDF

PdfDocument.FromFile方法是用于加载我们编写并打算用页码增强的现有PDF文档文件格式的函数。

# Import PdfDocument from IronPDF
from ironpdf import PdfDocument

# Load the existing PDF document
document = PdfDocument.FromFile("example.pdf")
Python

创建用于添加页码的HTML页脚

IronPDF允许创建带页面范围数和自定义HTML页眉和页脚的选定页面,提供了一种灵活的方法来制作包含动态内容的页面。 在我们的案例中,我们创建的页面带有包含页码的HTML页脚。

# Import HtmlHeaderFooter from IronPDF
from ironpdf import HtmlHeaderFooter

# Create an HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15  # Set the maximum height of the footer
footer.DrawDividerLine = True  # Draw a dividing line in the footer
footer.HtmlFragment = "<center><i>{page}</i></center>"  # HTML for page number
Python

向PDF添加页码

AddHtmlFooters方法是该过程中关键的一步。 24. 它集成了读取器,将自定义 HTML 页脚写入 PDF 文档输出文件,有效地为每个输出的 PDF 页添加页码。

# Add the HTML footers to the PDF document
document.AddHtmlFooters(footer)
Python

保存已修改的PDF

最后,SaveAs方法用于保存修改后的输出PDF文件,它完全包含所有新创建和添加的页码。

# Save the modified PDF document with page numbers
document.SaveAs("Modified_Output.pdf")
Python

总体实现

到目前为止,我们已经讨论了我们用来为上面的PDF文件格式创建和导入PDF的功能。 请查看下面代码的整体Python实现,其中页码被添加到页面底部的中心。

from ironpdf import ChromePdfRenderer, PdfDocument, HtmlHeaderFooter

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Load PDF document
document = PdfDocument.FromFile("example.pdf")
print(f"Number of pages in the document: {document.PageCount}")

# Create HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15
footer.DrawDividerLine = True
footer.HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"

# Add page numbers to the PDF
document.AddHtmlFooters(footer)

# Save the modified PDF
document.SaveAs("Modified.pdf")
Python

下图是一个将在PDF中居中页码的输出文件。

如何在Python中向PDF添加页码:图1 - 图像中心的页码

页码在右侧

要使页码出现在页脚的右侧,请使用以下代码:

from ironpdf import ChromePdfRenderer, PdfDocument, HtmlHeaderFooter

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Load PDF document
document = PdfDocument.FromFile("example.pdf")
print(f"Number of pages in the document: {document.PageCount}")

# Create HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15
footer.DrawDividerLine = True
footer.HtmlFragment = "<div style='text-align: right;'><i>{page} of {total-pages}</i></div>"

# Add page numbers to the PDF
document.AddHtmlFooters(footer)

# Save the modified PDF
document.SaveAs("Modified.pdf")
Python

下图显示了将页码放置在页脚右侧的输出结果。

如何在Python中向PDF添加页码:图2 - 图像右侧的页码

页码在左侧

类似地,要将页码放在页脚的左侧,请使用以下代码:

from ironpdf import ChromePdfRenderer, PdfDocument, HtmlHeaderFooter

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Load PDF document
document = PdfDocument.FromFile("example.pdf")
print(f"Number of pages in the document: {document.PageCount}")

# Create HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15
footer.DrawDividerLine = True
footer.HtmlFragment = "<div style='text-align: left;'><i>{page} of {total-pages}</i></div>"

# Add page numbers to the PDF
document.AddHtmlFooters(footer)

# Save the modified PDF
document.SaveAs("Modified.pdf")
Python

下图显示了将页码放置在页脚左侧的输出结果。

如何在Python中向PDF添加页码:图3 - 图像左侧的页码

真实的使用案例

让我们探索许多实际示例和用例,在这些中,以编程方式添加页码变得至关重要。

生成报告

在商业应用中,自动生成报告文件是常见的需求。 添加页码可确保报告井然有序且专业。

学术文档

对于学术机构或研究人员,例如,动态地为研究论文或学术文档添加页码简化了阅读和引用过程。

法律文档

在法律领域,维护版本控制并确保正确的文件分页和文件命名至关重要。 自动化添加页码简化了这一过程。

电子书和出版物

在处理数字出版物或电子书时,提供一致的阅读体验是至关重要的。 页码和字体都对文档页面的整体可读性和导航做出了贡献。

结论

在这篇详细探讨的文章中,我们深入研究了通过无缝结合页码来增强PDF文档输出的复杂过程,使用Python中的IronPDF。 提供的代码采取系统的方法输出,确保路径清晰,输出明确,易于理解。

需要注意的是,本指南作为基础,鼓励开发人员根据具体需求调整提供的代码。 此外,IronPDF为开发目的提供免费试用,以便在购买前进行评估。 有关许可详情、高级功能和支持的更多信息,请访问官方IronPDF网站。

随着PDF文件操作工具领域的不断演进,IronPDF作为开发人员寻求自动化和增强其PDF文件和图像相关工作流的有价值资产而脱颖而出。 如果您想了解更多关于Python中IronPDF的信息,您可以通过此处链接获取许可详情和更多信息。

如果您希望在页面断裂后在HTML中添加页码,您可以在此处找到一个示例。

快乐的PDF文件编程!

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...
阅读更多

相关文章

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

OR
bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起