Function rebuild_outlines

pdfarranger/exporter_outlines.py:192–212

Rebuild outlines in pdf_output by remapping bookmarks from pdf_input.

(pdf_input, pdf_output, pages)

def rebuild_outlines(pdf_input, pdf_output, pages):
    """Rebuild outlines in pdf_output by remapping bookmarks from pdf_input."""
    remapper = OutlineRemapper(pdf_input, pdf_output, pages)
    # preserve first-appearance order of source files, deduplicated
    ordered_file_indices = list(dict.fromkeys(row.nfile - 1 for row in pages))
    with pdf_output.open_outline() as new_outline:
        for file_idx in ordered_file_indices:
            source_pdf = pdf_input[file_idx]
            if source_pdf is None or pikepdf.Name.Outlines not in source_pdf.Root:
                continue
            try:
                with source_pdf.open_outline() as source_outline:
                    copier = OutlineCopier(remapper, file_idx)
                    for item in source_outline.root:
                        copier.copy_item(item, new_outline.root)
            except pikepdf.PdfError as e:
                warnings.warn(
                    f"Failed to copy bookmarks from document {file_idx + 1}: {e}"
                )
    if remapper.new_named_dests:
        write_named_dests(pdf_output, remapper.new_named_dests)