python办公自动化：使用`python-docx`处理页眉、页脚与页码

在处理Word文档时，页眉、页脚和页码的操作是非常常见的需求。python-docx库提供了丰富的接口，让我们可以灵活地自定义和操作这些元素。本章将详细介绍如何使用python-docx库添加和定制Word文档的页眉、页脚以及页码。

1 页眉的创建与操作

页眉通常包含文档标题、公司标志、日期等信息，并且会在每一页的顶部重复出现。使用python-docx，我们可以轻松地为文档添加页眉。

1.1 创建页眉

首先，我们来看看如何创建一个简单的页眉。

from docx import Document

# 创建一个新的Word文档
doc = Document()

# 添加一个节并设置其页眉
section = doc.sections[0]
header = section.header

# 向页眉中添加段落和文本
header_paragraph = header.paragraphs[0]
header_paragraph.text = "公司名称 - 项目报告"

# 保存文档
doc.save('header_example.docx')

在这个示例中，我们创建了一个新的Word文档，并向其第一个节添加了一个页眉。然后在页眉中添加了一段文本。

1.2 自定义页眉样式

我们可以通过设置段落和字符的格式，来自定义页眉的样式。

from docx.shared import Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH

# 设置字体大小、字体和对齐方式
header_paragraph.style.font.size = Pt(14)
header_paragraph.style.font.name = 'Arial'
header_paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER

这个代码片段显示了如何设置页眉文本的字体大小、字体以及对齐方式。你可以根据需要调整这些参数。

2 页脚的创建与操作

页脚一般用于显示页码、版权信息等内容。与页眉类似，python-docx也提供了灵活的接口来处理页脚。

2.1 创建页脚

让我们创建一个包含版权信息的页脚。

# 添加一个节并设置其页脚
footer = section.footer

# 向页脚中添加段落和文本
footer_paragraph = footer.paragraphs[0]
footer_paragraph.text = "© 2024 公司名称. 保留所有权利."

# 保存文档
doc.save('footer_example.docx')

此代码在文档的页脚中添加了版权声明。

2.2 自定义页脚样式

与页眉类似，我们也可以对页脚进行自定义样式设置。

# 设置字体大小、字体和对齐方式
footer_paragraph.style.font.size = Pt(10)
footer_paragraph.style.font.name = 'Times New Roman'
footer_paragraph.alignment = WD_ALIGN_PARAGRAPH.RIGHT

在这个示例中，我们将页脚文本的字体大小设置为10pt，并将其右对齐。

3 页码的添加与格式化

页码是文档中不可或缺的元素，特别是在长文档中。python-docx允许我们轻松地向文档添加页码。

3.1 简单页码的添加

我们可以在页脚中添加页码，这通常是最常见的用法。

# 添加页码到页脚
footer_paragraph = footer.add_paragraph()
footer_paragraph.text = "第 "
footer_paragraph.add_run().text = '1'  # 简单示例，手动设置页码
footer_paragraph.add_run().text = " 页"

# 保存文档
doc.save('page_number_example.docx')

此示例中，我们手动添加了一个页码。虽然这在实际中不常见，但可以与其他文本组合形成复杂的页码样式。

3.2 使用域自动生成页码

python-docx目前不支持直接插入页码域，不过我们可以使用模板来实现页码自动生成。

首先，在Word中创建一个包含页码的模板，然后使用python-docx进行内容填充。

# 打开包含页码的模板
doc = Document('template_with_page_number.docx')

# 添加内容
doc.add_paragraph("这是一个包含页码的文档示例。")

# 保存文档
doc.save('filled_template_with_page_number.docx')

这种方法利用了Word模板的功能，避免了手动添加页码的繁琐步骤。

4 页眉、页脚与页码的综合应用

在实际应用中，页眉、页脚和页码通常会一起使用，形成统一的页面布局。下面是一个综合的示例。

from docx import Document
from docx.shared import Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH

# 创建文档
doc = Document()

# 获取节并设置页眉
section = doc.sections[0]
header = section.header
header_paragraph = header.paragraphs[0]
header_paragraph.text = "公司名称 - 项目报告"
header_paragraph.style.font.size = Pt(14)
header_paragraph.style.font.name = 'Arial'
header_paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER

# 设置页脚
footer = section.footer
footer_paragraph = footer.paragraphs[0]
footer_paragraph.text = "© 2024 公司名称. 保留所有权利."
footer_paragraph.style.font.size = Pt(10)
footer_paragraph.style.font.name = 'Times New Roman'
footer_paragraph.alignment = WD_ALIGN_PARAGRAPH.RIGHT

# 添加页码到页脚
footer_paragraph = footer.add_paragraph()
footer_paragraph.text = "第 1 页"

# 保存文档
doc.save('complete_example.docx')

这个示例展示了如何在同一个文档中同时处理页眉、页脚和页码，形成统一的页面布局。