Python处理PDF：在PDF文档中插入页眉和页脚

布满荆棘的人生 2024-05-01 03:31 7阅读 0赞

在处理篇幅较长、结构复杂的PDF文档时，页眉和页脚的设计与插入就显得尤为重要。它们不仅扮演着美化文档、提升专业度的角色，更承担了导航指引、信息标注的重要功能。  
页眉通常用于展示文档的标题或章节名称，有助于读者在翻阅过程中迅速定位所处位置，对文档的整体结构一目了然。同时，也可以利用页眉添加公司logo、版权声明等信息，增强文档的品牌识别度和法律效力。而页脚则常用来放置页码、日期、作者姓名、文档版本等细节信息，便于文档管理和查阅，特别是对于长篇报告、学术论文或是多页合订本而言，连续且准确的页码至关重要。  
本文将介绍如何使用**Python代码操作PDF文档**，**在PDF文档中插入自定义的页眉和页脚**。

#### 文章目录 ####

*   *  用Python在PDF文档中插入页眉
     *  用Python在PDF文档中插入页脚

本文所使用的方法需要用到[Spire.PDF for Python][]，PyPI：`pip install Spire.Doc`。

### 用Python在PDF文档中插入页眉 ###

要在PDF文档中添加由文本、图像、线条和部分编号组成的页眉，可以按照以下步骤进行操作：

1.  创建 **PdfDocument** 对象。
2.  从指定路径加载现有的PDF文档。
3.  定义页眉的内容：
    
     *  指定要添加到页眉的文本。
     *  加载用于页眉的图像。
4.  遍历每个页面并将页眉内容添加到指定位置：
5.  使用 **Canvas.DrawString()**、**Canvas.DrawImage()** 和 **Canvas.DrawLine()** 方法，在考虑页面大小和页边距的情况下，将页眉内容添加到每个页面的特定位置。
6.  将修改后的PDF保存为新文件或覆盖现有文件。

**代码示例：**

from spire.pdf.common import *
    from spire.pdf import *
    
    # 创建PdfDocument对象
    pdf = PdfDocument()
    
    # 加载PDF文件
    pdf.LoadFromFile("示例.pdf")
    
    # 加载图像
    headerImage = PdfImage.FromFile("G:/Documents/Header.png")
    
    # 获取图像的像素宽度
    width = headerImage.Width
    
    # 获取图像的点单位宽度
    unitCvtr = PdfUnitConvertor()
    pointWidth = unitCvtr.ConvertUnits(width, PdfGraphicsUnit.Pixel, PdfGraphicsUnit.Point)
    
    # 创建字体、刷子和笔
    firstFont = PdfTrueTypeFont("HarmonyOS Sans SC", 18.0, PdfFontStyle.Bold, True)
    brush = PdfBrushes.get_DarkBlue()
    pen = PdfPen(PdfBrushes.get_Black(), 1.5)
    
    # 指定要添加到页眉的文本
    headerText = "代糖与健康"
    
    # 创建PdfSectionNumberField对象
    sectionField = PdfSectionNumberField(firstFont, brush)
    
    # 迭代文档中的页面
    for i in range(pdf.Pages.Count):
    
        # 获取特定页面
        page = pdf.Pages[i]
    
        # 在指定位置绘制图像
        page.Canvas.DrawImage(headerImage, page.ActualSize.Width - pointWidth - 72.0, 5.0)
    
        # 在指定位置绘制字符串
        page.Canvas.DrawString(headerText, firstFont, brush, 72.0, 25.0)
    
        # 在指定位置绘制线条
        page.Canvas.DrawLine(pen, 72.0, 50.0, page.ActualSize.Width - 72.0, 50.0)
    
    # 将更改保存到另一个PDF文件
    pdf.SaveToFile("Output/PDF页眉.pdf")
    
    # 释放资源
    pdf.Dispose()

**结果文档：**  
![用Python在PDF文档中插入页眉][Python_PDF]

### 用Python在PDF文档中插入页脚 ###

以下是向PDF文档添加包含"第 X 页，共 Y 页"的页脚的操作步骤：

1.  创建PdfDocument对象。
2.  从指定路径加载现有的PDF文档。
3.  定义页脚内容：  
    创建PdfPageNumberField对象以获取当前页码。  
    创建PdfPageCountField对象以获取总页数。可以使用这两个自动字段和文本结合的方式创建"X / Y"格式，可以使用PdfCompositeField对象实现。
4.  将页脚添加到每个页面：  
    迭代PDF文档的每个页面，并使用Canvas.DrawLine()方法添加线条。  
    使用PdfCompositeField.Draw()方法将页码和总页数添加到页脚区域。在调用这些方法时，需要考虑页面的尺寸和边距以确定位置。
5.  将修改后的PDF保存到新文件或覆盖现有文件中。

**代码示例：**

from spire.pdf.common import *
    from spire.pdf import *
    
    # 创建PdfDocument对象
    pdf = PdfDocument()
    
    # 加载PDF文件
    pdf.LoadFromFile("示例.pdf")
    
    # 创建字体、刷子和笔
    font = PdfTrueTypeFont("HarmonyOS Sans SC", 12.0, PdfFontStyle.Bold, True)
    brush = PdfBrushes.get_Black()
    pen = PdfPen(brush, 1.5)
    
    # 创建PdfPageNumberField对象和PdfPageCountField对象
    pageNumberField = PdfPageNumberField()
    pageCountField = PdfPageCountField()
    
    # 创建将页数字段和页码字段合并为一个字符串的PdfCompositeField对象
    compositeField = PdfCompositeField(font, brush, "第 {0} 页，共 {1} 页", [pageNumberField, pageCountField])
    
    # 获取页面尺寸
    pageSize = pdf.Pages[0].Size
    
    # 设置组合字段的位置
    compositeField.Location = PointF(72.0, pageSize.Height - 45.0)
    
    # 迭代文档中的页面
    for i in range(pdf.Pages.Count):
    
        # 获取特定页面
        page = pdf.Pages[i]
    
        # 在指定位置绘制线条
        page.Canvas.DrawLine(pen, 72.0, pageSize.Height - 50.0, pageSize.Width - 72.0, pageSize.Height - 50.0)
    
        # 在页面上绘制组合字段
        compositeField.Draw(page.Canvas, 0.0, 0.0)
    
    # 将修改后的PDF保存到新文件
    pdf.SaveToFile("Output/PDF页脚.pdf")
    
    # 释放资源
    pdf.Dispose()

**结果文档：**  
![用Python在PDF文档中插入页脚][Python_PDF 1]

本文演示了如何使用Python插入页眉和页脚到PDF文档。

更多 PDF 文档操作技巧请前往[Spire.PDF for Python教程][Spire.PDF for Python]。

[申请免费许可][Link 1]

[Spire.PDF for Python]: https://www.e-iceblue.cn/Downloads/Spire-PDF-Python.html
[Python_PDF]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/d66e0e12e94d49bd8ba7cc00e4c90238.png
[Python_PDF 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/bfef3892341b4cb9aed0da29bac440cb.png
[Link 1]: https://www.e-iceblue.com/TemLicense.html