【python-docx 05】操作页眉和页脚

Word支持页眉和页脚。页眉是出现在每个页面的上边距区域中的文本，与文本主体分开，并且通常传达上下文信息，例如文档标题，作者，创建日期或页码。文档中的页眉在页面之间是相同的，内容上只有很小的差异，例如更改部分标题或页码。页眉也称为运行头。

页脚在页眉的每个方面都类似，只不过它出现在页面底部。它不应与脚注混淆，脚注在页面之间内容是不一致的。

访问章节的标题

页眉和页脚与一个部分相关联，这允许每个部分具有不同的页眉和/或页脚。例如，横向部分可能具有比纵向部分更宽的标题。

每个section对象都有一个.header属性，可以访问该节的_Header对象：

document = Document()
section = document.sections[0]
header = section.header
print(header)
# <docx.section._Header object at 0x...>

即使没有为该部分定义头文件，Section.header上也始终存在_Header对象。_Header.is_linked_to_previous表示存在实际的头定义：

>>> header.is_linked_to_previous
True

值为True表示_Header对象不包含标题定义，该章节将显示与上一节相同的标题。这种“继承”行为是递归的，因此“链接”标题实际上从具有标题定义的第一个前一部分获得其定义。此“链接”状态在Word中显示为“与以前相同”。

新文档没有标题（在它包含的单个部分），因此.is_linked_to_previous在这种情况下为True。请注意，这种情况可能有点违反直觉，因为没有要链接的前一个节头。在此“无前一个标题”的情况下，不显示标题。

添加页眉（简单的情况）

只需编辑_Header对象的内容即可将标题添加到新文档中。_Header对象是一个容器，其内容的编辑方式与Document对象类似。请注意，与新文档一样，新标题已包含单个（空）段落：

document = Document()
section = document.sections[0]
header = section.header
paragraph = header.paragraphs[0]
paragraph.text = "这就是页眉"

实现的效果在word中就是如下所示：

另请注意，添加内容（甚至只是访问header.paragraphs）的行就会为添加了页眉的定义并更改了.is_linked_to_previous的状态：

>>> header.is_linked_to_previous
False

添加“分区”标题内容

具有多个“区域”的标题通常使用精心放置的制表位来完成。
中心和右对齐“区域”所需的制表位是Word中潜在标题样式的一部分。

但默认的python-docx模板中不存在该样式，需要添加：

from docx.enum.style import WD_STYLE_TYPE
from docx.enum.text import WD_TAB_ALIGNMENT

styles = document.styles
style = styles.add_style("Header", WD_STYLE_TYPE.PARAGRAPH)
style.base_style = styles["Normal"]
tab_stops = style.paragraph_format.tab_stops
tab_stops.add_tab_stop(Inches(3.25), WD_TAB_ALIGNMENT.CENTER)
tab_stops.add_tab_stop(Inches(6.5), WD_TAB_ALIGNMENT.RIGHT)

如果使用的是自定义模板而不是python-docx默认模板，那么在模板中定义该样式很有意义。

一旦存在标题样式，标签将用于分隔左，中和右对齐的标题内容：

paragraph = header.paragraphs[0]
paragraph.text = "这是页眉1\这是页眉2\这是页眉3"
paragraph.style = document.styles["Header"]

删除页眉

通过将True分配给其.is_linked_to_previous属性，可以删除不需要的标头：

>>> header.is_linked_to_previous = True
>>> header.is_linked_to_previous
True

当True被分配给.is_linked_to_previous时，标题的内容将被不可逆转地删除。

了解多节文档中的页眉

对于简单的情况，“刚开始编辑”方法可以很好地工作，但是为了理解多节文档中页眉的行为，一些简单的概念将是有帮助的。简而言之：

1. 每个章节都可以有自己的页眉定义（但不是必须的）。
2. 缺少页眉定义的部分会继承之前章节的页眉。_Header.is_linked_to_previous属性仅反映页眉是否存在，当存在时为False，否则为True。
3. 无页眉是默认状态。新文档没有已定义的页眉，也没有新插入的章节。.is_linked_to_previous在这两种情况下都设定为True。
4. 如果_Header对象具有页眉定义，则它的内容是它自己的内容。如果不是，则其内容是具有页眉定义的前一部分第一个的内容。如果没有章节具有标题定义，则在第一章节中添加新章节，并且所有其他章节继承该章节。在第一次访问页眉内容时，可能通过引用header.paragraphs来添加头定义。

添加页眉（一般情况）

通过为.is_linked_to_previous属性赋值为False，可以将页眉定义指定给缺少页眉的章节

>>> header.is_linked_to_previous
True
>>> header.is_linked_to_previous = False
>>> header.is_linked_to_previous
False

新添加的页眉包含一个空段落。请注意，以这种方式保留页眉偶尔会有用，因为它有效地“关闭”该部分的页眉以及之后的页眉，直到具有已定义页眉的下一部分。