Создание и настройка разделов документа в Python для работы со страницами

Расширенные примеры работы со страницами в python-docx

Пример 1. Создание документа с несколькими разделами: разная ориентация и поля

В этом примере создаётся документ из трёх разделов. Первый - портретный с обычными полями, второй - портретный с широкими полями, третий - альбомный с узкими полями. Для каждого раздела добавляется содержимое.

from docx import Document
from docx.enum.section import WD_ORIENT, WD_SECTION_START
from docx.shared import Cm

doc = Document()

# Раздел 1: портретный, поля 2.5 см
sec1 = doc.sections[0]
sec1.orientation = WD_ORIENT.PORTRAIT
sec1.page_width = Cm(21)
sec1.page_height = Cm(29.7)
sec1.margins.left = Cm(2.5)
sec1.margins.right = Cm(2.5)
sec1.margins.top = Cm(2.5)
sec1.margins.bottom = Cm(2.5)
doc.add_paragraph('Первый раздел (портрет, поля 2.5 см)')

# Добавляем разрыв страницы внутри раздела
doc.add_page_break()
doc.add_paragraph('Ещё один абзац в первом разделе')

# Раздел 2: портретный, но поля 4 см
sec2 = doc.add_section(WD_SECTION_START.NEW_PAGE)
sec2.orientation = WD_ORIENT.PORTRAIT
sec2.page_width = Cm(21)
sec2.page_height = Cm(29.7)
sec2.margins.left = Cm(4)
sec2.margins.right = Cm(4)
sec2.margins.top = Cm(2)
sec2.margins.bottom = Cm(2)
doc.add_paragraph('Второй раздел (портрет, увеличенные боковые поля)')

# Раздел 3: альбомный, узкие поля
sec3 = doc.add_section(WD_SECTION_START.NEW_PAGE)
sec3.orientation = WD_ORIENT.LANDSCAPE
sec3.page_width = Cm(29.7)
sec3.page_height = Cm(21)
sec3.margins.left = Cm(1)
sec3.margins.right = Cm(1)
sec3.margins.top = Cm(1)
sec3.margins.bottom = Cm(1)
doc.add_paragraph('Третий раздел (альбом, поля 1 см)')

doc.save('multi_sections.docx')

Результат: файл будет содержать три раздела с заданными параметрами. При открытии в Word можно увидеть разные ориентации и поля на каждой странице-разделе.

Пример 2. Вставка номеров страниц в нижний колонтитул с разным форматом для разных разделов

Используя XML, вставляем поле PAGE в нижний колонтитул первого раздела, а во втором разделе добавляем ещё и номер раздела.

from docx import Document
from docx.oxml.ns import qn
from copy import deepcopy

def add_page_number_to_footer(section):
    footer = section.footer
    paragraph = footer.paragraphs[0]
    run = paragraph.add_run()
    
    # Создаём поле PAGE
    fld_char_begin = run._r.makeelement(qn('w:fldChar'), {qn('w:fldCharType'): 'begin'})
    run._r.append(fld_char_begin)
    instr = run._r.makeelement(qn('w:instrText'), {})
    instr.text = ' PAGE '
    run._r.append(instr)
    fld_char_separate = run._r.makeelement(qn('w:fldChar'), {qn('w:fldCharType'): 'separate'})
    run._r.append(fld_char_separate)
    # Можно добавить текст-заполнитель
    run = paragraph.add_run(' ')
    fld_char_end = run._r.makeelement(qn('w:fldChar'), {qn('w:fldCharType'): 'end'})
    run._r.append(fld_char_end)
    
def add_section_number_to_footer(section):
    footer = section.footer
    paragraph = footer.paragraphs[0]
    run = paragraph.add_run()
    # Поле SECTION
    fld_char_begin = run._r.makeelement(qn('w:fldChar'), {qn('w:fldCharType'): 'begin'})
    run._r.append(fld_char_begin)
    instr = run._r.makeelement(qn('w:instrText'), {})
    instr.text = ' SECTION '
    run._r.append(instr)
    fld_char_separate = run._r.makeelement(qn('w:fldChar'), {qn('w:fldCharType'): 'separate'})
    run._r.append(fld_char_separate)
    run = paragraph.add_run(' ')
    fld_char_end = run._r.makeelement(qn('w:fldChar'), {qn('w:fldCharType'): 'end'})
    run._r.append(fld_char_end)

doc = Document()
# Добавляем два раздела
sec1 = doc.sections[0]
add_page_number_to_footer(sec1)
doc.add_paragraph('Первый раздел. Номер страницы внизу.')

sec2 = doc.add_section()
sec2.header.is_linked_to_previous = False  # отключаем связь
add_page_number_to_footer(sec2)
add_section_number_to_footer(sec2)  # добавим ещё и номер раздела
doc.add_paragraph('Второй раздел. Внизу номер страницы и номер раздела.')

doc.save('page_and_section_numbers.docx')

Результат: при открытии документа в Word в нижнем колонтитуле первого раздела отобразится номер страницы, во втором - номер страницы и номер раздела. Поля обновятся при загрузке или по нажатию Ctrl+F9.

Пример 3. Добавление разрыва страницы при создании списка элементов

Предположим, нужно сгенерировать отчёт, где каждый новый элемент начинается с новой страницы. Можно использовать цикл с doc.add_page_break().

from docx import Document
from docx.shared import Pt

doc = Document()

elements = [
    ('Отчёт 1', 'Текст первого отчёта'),
    ('Отчёт 2', 'Текст второго отчёта'),
    ('Отчёт 3', 'Текст третьего отчёта'),
]

for i, (title, text) in enumerate(elements):
    if i > 0:
        doc.add_page_break()  # новая страница для каждого, кроме первого
    doc.add_heading(title, level=1)
    doc.add_paragraph(text)

doc.save('reports.docx')

Результат: документ с тремя страницами, на каждой - заголовок и абзац текста.

Пример 4. Изменение начального номера страницы в разделе

Иногда требуется начать нумерацию страниц с определённого числа. Для этого используется свойство section.page_numbering_start.

from docx import Document

doc = Document()

# Первый раздел: номера не показываем (не вставляли поле), но можно задать старт
sec1 = doc.sections[0]
sec1.page_numbering_start = 5  # начать нумерацию с 5

# Второй раздел: сбросить нумерацию
sec2 = doc.add_section()
sec2.page_numbering_start = 1  # начать заново с 1

doc.add_paragraph('Первый раздел (номера с 5)')
doc.add_paragraph('Текст')
doc.add_page_break()
doc.add_paragraph('Второй раздел (номера с 1)')

doc.save('page_start.docx')

Результат: Если вставить поля PAGE в колонтитулы, то в первом разделе страницы будут нумероваться с 5, во втором - с 1.