Офис и PDF

Добавить номера страниц в PDF

Печатает номера внизу страницы с настраиваемым форматом, размером и пропуском обложки.

Python Windows macOS Linux Средний
Скачать add_page_numbers.py
Описание

Что делает скрипт

Скрипт создаёт прозрачный слой с номером для каждой страницы и накладывает его через pypdf. Формат по умолчанию выглядит как 1 / 10, можно изменить отступ, размер шрифта и начальный номер. Флаг --skip-first оставляет обложку без номера.

Перед запуском
  • Стандартный шрифт Helvetica не поддерживает кириллицу. Используйте латиницу и цифры.
Запуск

Быстрый старт

python add_page_numbers.py report.pdf

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python add_page_numbers.py book.pdf --skip-first --start 1
  • python add_page_numbers.py contract.pdf --format 'Page {page} of {total}' --font-size 9
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
pypdf
Windows py -m pip install pypdf
macOS python3 -m pip install pypdf
Linux python3 -m pip install pypdf
reportlab
Windows py -m pip install reportlab
macOS python3 -m pip install reportlab
Linux python3 -m pip install reportlab
Исходник

add_page_numbers.py

#!/usr/bin/env python3
"""Добавление номеров страниц в PDF через прозрачный слой reportlab."""
from __future__ import annotations

import argparse
import io
import sys
from pathlib import Path

from pypdf import PdfReader, PdfWriter
from pypdf.errors import PdfReadError
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfgen import canvas

FONT = "Helvetica"


def main() -> int:
    parser = argparse.ArgumentParser(description="Добавить номера страниц в PDF")
    parser.add_argument("input", type=Path, help="Исходный PDF")
    parser.add_argument("--format", default="{page} / {total}", help="Шаблон номера")
    parser.add_argument("--start", type=int, default=1, help="Первый номер")
    parser.add_argument("--font-size", type=float, default=10.0, help="Размер шрифта")
    parser.add_argument("--margin", type=float, default=24.0, help="Отступ от края в пунктах")
    parser.add_argument("--position", choices=("center", "left", "right"), default="center", help="Положение номера")
    parser.add_argument("--skip-first", action="store_true", help="Не нумеровать первую страницу")
    parser.add_argument("--outdir", type=Path, default=Path("numbered"), help="Папка результатов")
    parser.add_argument("--force", action="store_true", help="Перезаписать результат")
    args = parser.parse_args()

    path = args.input.expanduser()
    if not path.is_file():
        print(f"Файл не найден: {path}", file=sys.stderr)
        return 2

    target = args.outdir.expanduser() / f"{path.stem}_numbered.pdf"
    if target.exists() and not args.force:
        print(f"Файл уже существует: {target}. Добавьте --force.", file=sys.stderr)
        return 2

    try:
        reader = PdfReader(str(path))
    except (PdfReadError, OSError) as error:
        print(f"Не удалось открыть PDF: {error}", file=sys.stderr)
        return 1

    total = len(reader.pages)
    writer = PdfWriter()
    for index, page in enumerate(reader.pages, start=1):
        if args.skip_first and index == 1:
            writer.add_page(page)
            continue

        number = args.start + index - 1
        try:
            label = args.format.format(page=number, total=total)
        except (KeyError, ValueError) as error:
            print(f"Неверный шаблон номера: {error}", file=sys.stderr)
            return 2
        width = float(page.mediabox.width)
        height = float(page.mediabox.height)
        buffer = io.BytesIO()
        layer = canvas.Canvas(buffer, pagesize=(width, height))
        layer.setFont(FONT, args.font_size)
        layer.setFillColorRGB(0.35, 0.35, 0.35)
        text_width = pdfmetrics.stringWidth(label, FONT, args.font_size)
        if args.position == "left":
            x = args.margin
        elif args.position == "right":
            x = width - args.margin - text_width
        else:
            x = (width - text_width) / 2
        try:
            layer.drawString(x, args.margin, label)
            layer.save()
        except Exception as error:
            print(f"Не удалось нарисовать номер: {error}", file=sys.stderr)
            return 1
        buffer.seek(0)
        overlay = PdfReader(buffer).pages[0]
        writer.add_page(page)
        writer.pages[-1].merge_page(overlay)

    target.parent.mkdir(parents=True, exist_ok=True)
    with target.open("wb") as handle:
        writer.write(handle)
    print(f"Готово: {target}, страниц: {total}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get office-pdf-page-numbers
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Офис и PDF

PDF, Word, Excel, презентации, документы и печать.