在Python .docx 模块中使用页眉和页脚

简介

Microsoft Word 中的“页眉”和“页脚”，是指固定在页面顶端或底端的文本或图像区域。在使用 Python 的 .docx 模块创建文档时，可以使用 .add_paragraph() 方法在其上方或下方创建新的段落，从而实现添加页眉和页脚的效果。

基本用法

在使用 .docx 模块创建文档时，可以使用以下代码片段添加页眉和页脚：

from docx import Document

document = Document()

# 添加页眉
header = document.sections[0].header
paragraph = header.paragraphs[0]
paragraph.text = "这是页眉"

# 添加页脚
footer = document.sections[0].footer
paragraph = footer.paragraphs[0]
paragraph.text = "这是页脚"

document.save('example.docx')

首先，我们创建了一个 Document 类的对象。然后，获取文档的第一个节，并使用 .header 和 .footer 属性获取其页眉和页脚的段落对象。最后，将所需文本添加到段落对象的 .text 属性中。

自定义样式

除了设置文本之外，您还可以使用 .paragraph_format 属性自定义样式。在以下示例中，我们使用 .margin_bottom 属性将页眉的底部边距设置为 1 英寸：

from docx import Document
from docx.enum.section import WD_SECTION

document = Document()

# 添加页眉
header = document.sections[0].header
paragraph = header.paragraphs[0]
paragraph.text = "这是页眉"

# 自定义样式
paragraph_format = paragraph.paragraph_format
paragraph_format.space_before = 0
paragraph_format.space_after = 0
paragraph_format.margin_bottom = 914400  # 1 英寸 = 914400 微米

# 添加页脚
footer = document.sections[0].footer
paragraph = footer.paragraphs[0]
paragraph.text = "这是页脚"

document.save('example.docx')

小结

在 Python .docx 模块中添加页眉和页脚非常容易，通过设置段落的 .text 属性以及使用 .paragraph_format 自定义样式即可实现。此外，使用 .header 和 .footer 属性可以轻松访问文本区域，并在其中添加所需的页眉和页脚。