Офис и PDF

Добавить закладки в PDF

Создаёт закладки по страницам или по коротким строкам-заголовкам из текста.

Python Windows macOS Linux Продвинутый
Скачать bookmark_pdf.py
Описание

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

Скрипт читает PDF, берёт первую содержательную строку страницы и добавляет её в оглавление. В режиме headings закладки создаются только для коротких строк, похожих на заголовки. Результат сохраняется отдельным файлом, исходник не меняется.

Запуск

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

python bookmark_pdf.py book.pdf --mode headings

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

Примеры

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

  • python bookmark_pdf.py report.pdf --mode pages --max-title 60
  • python bookmark_pdf.py manual.pdf --mode headings --outdir nav --force
Зависимости

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

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
pdfplumber
Windows py -m pip install pdfplumber
macOS python3 -m pip install pdfplumber
Linux python3 -m pip install pdfplumber
Исходник

bookmark_pdf.py

#!/usr/bin/env python3
"""Создание закладок PDF по тексту страниц."""
from __future__ import annotations

import argparse
import sys
from pathlib import Path

import pdfplumber
from pypdf import PdfReader, PdfWriter
from pypdf.errors import PdfReadError


def first_line(text: str) -> str:
    for line in text.splitlines():
        line = " ".join(line.split())
        if line:
            return line
    return ""


def looks_like_heading(line: str) -> bool:
    if not line or len(line) > 90 or line.endswith("."):
        return False
    return line[0].isdigit() or line[0].isupper()


def main() -> int:
    parser = argparse.ArgumentParser(description="Добавить закладки в PDF")
    parser.add_argument("input", type=Path, help="Исходный PDF")
    parser.add_argument("--mode", choices=("pages", "headings"), default="pages", help="Страницы или заголовки")
    parser.add_argument("--max-title", type=int, default=80, help="Максимальная длина закладки")
    parser.add_argument("--password", help="Пароль PDF")
    parser.add_argument("--outdir", type=Path, default=Path("bookmarked"), 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}_bookmarked.pdf"
    if target.exists() and not args.force:
        print(f"Файл уже существует: {target}. Добавьте --force.", file=sys.stderr)
        return 2

    try:
        reader = PdfReader(str(path))
        if reader.is_encrypted and not reader.decrypt(args.password or ""):
            print("Неверный пароль", file=sys.stderr)
            return 2
        with pdfplumber.open(str(path), password=args.password or "") as pdf:
            lines = [first_line(page.extract_text() or "") for page in pdf.pages]
    except (PdfReadError, OSError, ValueError) as error:
        print(f"Не удалось прочитать PDF: {error}", file=sys.stderr)
        return 1
    except Exception as error:
        print(f"Ошибка извлечения текста: {error}", file=sys.stderr)
        return 1

    writer = PdfWriter()
    for page in reader.pages:
        writer.add_page(page)

    added = 0
    for index, line in enumerate(lines):
        if args.mode == "headings" and not looks_like_heading(line):
            continue
        title = (line or f"Страница {index + 1}")[: args.max_title]
        writer.add_outline_item(title, index)
        added += 1

    target.parent.mkdir(parents=True, exist_ok=True)
    with target.open("wb") as handle:
        writer.write(handle)
    print(f"Готово: {target}, закладок: {added}")
    return 0 if added else 1


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

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

CLI 1.0.0

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

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

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

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

Категория

Офис и PDF

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