Добавить номера страниц в PDF
Печатает номера внизу страницы с настраиваемым форматом, размером и пропуском обложки.
Что делает скрипт
Скрипт создаёт прозрачный слой с номером для каждой страницы и накладывает его через 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 1python add_page_numbers.py contract.pdf --format 'Page {page} of {total}' --font-size 9
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install pypdf
python3 -m pip install pypdf
python3 -m pip install pypdf
py -m pip install reportlab
python3 -m pip install reportlab
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.