在 Python 中创建 PDF 小册子

从多个页面生成紧凑、可打印的 PDF 是报告、目录和手册的常见需求。 Aspose.PDF for Python via .NET 提供了强大的 SDK，允许您以细粒度控制在 Python 中以编程方式创建 PDF 小册子。在本指南中，您将看到如何设置环境、构建小册子、可选地添加书签以及导出最终文档。

什么是 PDF 小册子？

PDF 小册子是一种文档，其布局使得多页可以打印、折叠，并像小书、手册、宣传册或目录一样阅读。小册子生成会重新排列页面，而不是保持页面的正常顺序，以便在打印和折叠后，正确的页面并排出现。

例如，手册布局可能会在纸张的左侧放置一页，在右侧放置另一页。双面打印并折叠后，页面会以正确的阅读顺序出现。

小册子通常用于：

产品目录
活动方案
培训手册
报告
使用指南
公司简介
宣传册
小型可打印书籍

在 Python 中，您可以自动化此过程，而无需在 PDF 编辑器中手动重新排列页面。

Python PDF 小册子生成器 API

要在 Python 中创建 PDF 小册子，我们将使用 Aspose.PDF for Python via .NET。它是一个 PDF 处理 API，允许 Python 开发者以编程方式创建、编辑、转换、拆分、合并、保护、注释和操作 PDF 文件。

对于小册子创建，关键类是：

pdf.facades.PdfFileEditor()

PdfFileEditor 类提供高级 PDF 文件操作功能。在本教程中，我们将使用其 make_booklet() 方法将现有 PDF 转换为小册子布局。

步骤 1：安装 Aspose.PDF SDK

首先，使用 pip 安装 Aspose.PDF for Python via .NET：

pip install aspose-pdf

步骤 2：准备输入 PDF

在创建小册子之前，请确保您已经拥有源 PDF 文件。对于本教程，我们将使用以下文件名：

input.pdf

输出小册子将保存为：

booklet.pdf

将输入 PDF 放在与 Python 脚本相同的目录中，或提供完整的文件路径。

示例：

project-folder/
│
├── input.pdf
└── create_booklet.py

第 3 步：在 Python 中创建简易 PDF 小册子

创建小册子的最简单方法是调用 make_booklet()，并提供输入文件、输出文件和目标页面尺寸。

以下 Python 代码使用 A5 页面尺寸创建小册子：

import aspose.pdf as pdf

# Create PdfFileEditor object
pdf_editor = pdf.facades.PdfFileEditor()

# Create booklet from input PDF
pdf_editor.make_booklet(
    "input.pdf",
    "booklet.pdf",
    pdf.PageSize.a5
)

print("PDF booklet created successfully.")

此代码加载 input.pdf，将其页面排列成小册子布局，并将结果保存为 booklet.pdf。

第 4 步：创建带有左页和右页的自定义 PDF 小册子

在许多情况下，您可能希望控制哪些页面出现在小册子布局的左侧，哪些页面出现在右侧。

以下示例基于原始的 C# 代码，并将其转换为 Python：

import aspose.pdf as pdf

# Create PdfFileEditor object
pdf_editor = pdf.facades.PdfFileEditor()

# Set left and right pages
left_pages = [1, 5]
right_pages = [2, 3]

# Make booklet
pdf_editor.make_booklet(
    "input.pdf",
    "booklet.pdf",
    pdf.PageSize.a5,
    left_pages,
    right_pages
)

print("PDF booklet created successfully.")

代码说明

让我们分解代码。

首先，导入 Aspose.PDF 包：

import aspose.pdf as pdf

然后创建 PdfFileEditor 的实例：

pdf_editor = pdf.facades.PdfFileEditor()

此对象提供对高级 PDF 编辑功能的访问，包括小册子创建。

接下来，定义页面布局：

left_pages = [1, 5]
right_pages = [2, 3]

left_pages 列表定义了将在小册子展开的左侧出现的页面。right_pages 列表定义了将在右侧出现的页面。

最后，调用 make_booklet() 方法：

pdf_editor.make_booklet(
    "input.pdf",
    "booklet.pdf",
    pdf.PageSize.a5,
    left_pages,
    right_pages
)

这将创建小册子并将其保存为 booklet.pdf。

完整的 Python 代码

以下是使用 Python 创建 PDF 小册子的完整代码示例：

import aspose.pdf as pdf

def create_pdf_booklet(input_pdf: str, output_pdf: str) -> None:
    """
    Create a PDF booklet from an existing PDF file using Aspose.PDF for Python via .NET.

Args:
        input_pdf: Path to the source PDF file.
        output_pdf: Path where the generated booklet PDF will be saved.
    """

# Create PdfFileEditor object
    pdf_editor = pdf.facades.PdfFileEditor()

# Set left and right pages
    left_pages = [1, 5]
    right_pages = [2, 3]

# Make booklet
    pdf_editor.make_booklet(
        input_pdf,
        output_pdf,
        pdf.PageSize.a5,
        left_pages,
        right_pages
    )

if __name__ == "__main__":
    create_pdf_booklet(
        input_pdf="input.pdf",
        output_pdf="booklet.pdf"
    )

print("PDF booklet created successfully.")

第5步：向小册子添加可选书签

创建小册子后，您可能想添加书签以便更轻松地导航。书签对于报告、手册、目录、培训指南以及其他长文档非常有用。

以下示例首先创建一个小册子，然后向生成的 PDF 添加书签：

import aspose.pdf as pdf

def create_pdf_booklet(input_pdf: str, output_pdf: str) -> None:
    """
    Create a PDF booklet from an existing PDF file.
    """

pdf_editor = pdf.facades.PdfFileEditor()

left_pages = [1, 5]
    right_pages = [2, 3]

pdf_editor.make_booklet(
        input_pdf,
        output_pdf,
        pdf.PageSize.a5,
        left_pages,
        right_pages
    )

def add_bookmarks(input_pdf: str, output_pdf: str) -> None:
    """
    Add bookmarks to an existing PDF document.
    """

# Open generated booklet PDF
    document = pdf.Document(input_pdf)

# Add bookmark for first page
    first_bookmark = pdf.OutlineItemCollection(document.outlines)
    first_bookmark.title = "Booklet Start"
    first_bookmark.bold = True
    first_bookmark.action = pdf.annotations.GoToAction(document.pages[1])
    document.outlines.append(first_bookmark)

# Add bookmark for second page, if available
    if len(document.pages) >= 2:
        second_bookmark = pdf.OutlineItemCollection(document.outlines)
        second_bookmark.title = "Second Spread"
        second_bookmark.action = pdf.annotations.GoToAction(document.pages[2])
        document.outlines.append(second_bookmark)

# Save PDF with bookmarks
    document.save(output_pdf)

if __name__ == "__main__":
    create_pdf_booklet(
        input_pdf="input.pdf",
        output_pdf="booklet.pdf"
    )

add_bookmarks(
        input_pdf="booklet.pdf",
        output_pdf="booklet-with-bookmarks.pdf"
    )

print("PDF booklet with bookmarks created successfully.")

此代码创建两个输出文件：

booklet.pdf
booklet-with-bookmarks.pdf

第一个文件包含小册子的布局。第二个文件包含已添加书签的小册子。

选择合适的页面尺寸

在上面的示例中，我们使用了 A5 页面尺寸：

pdf.PageSize.a5

A5 通常用于小册子，因为它体积紧凑，适合印刷手册、宣传册和小型目录。

您可以根据输出需求使用其他页面尺寸。例如，如果您正在创建更大的小册子，您可以使用 A4。如果您在准备一本紧凑的手册，A5 可能更合适。

常见的小册子使用案例包括：

用例	建议页面尺寸
小手册	A5
产品目录	A5 或 A4
活动节目单	A5
培训讲义	A4 或 A5
公司宣传册	A5

创建 PDF 小册子的最佳实践

在以编程方式生成小册子时，请记住以下要点。

1. 使用干净的源 PDF

您的输入 PDF 应该已经正确格式化。小册子生成会重新排列页面，但不会重写每页的内部内容。

在创建小册子之前，请检查：

页面边距
页眉和页脚位置
字体嵌入
图像质量
页面方向
出血或安全打印区域

2. 检查页数

小册子在页数适合折叠和打印时效果最佳。如果页数不能完全对齐，可能需要添加空白页。

例如，折页小册子可能需要以四的倍数的页数，因为每张折叠的纸张会产生四个页面面。

3. 批量打印前的测试打印

在批量打印小册子之前，请先打印一份测试副本。PDF 查看器和打印机设置可能会影响缩放、边距、双面模式和页面方向。

推荐的打印机设置可能包括：

双面打印
根据打印机选择短边翻转或长边翻转
实际尺寸
不自动缩放
正确的纸张尺寸

4. 为数字副本添加书签

如果小册子也将以数字方式共享，书签可以改善导航。它们帮助读者快速跳转到重要章节。

书签特别适用于：

长报告
技术手册
政策文件
产品目录
培训材料

5. 使用清晰的文件名

在批量生成文档时，请为输出文件使用描述性的名称。

例如：

employee-handbook-booklet.pdf
product-catalog-booklet.pdf
training-manual-booklet.pdf

常见错误及解决方案

错误: ModuleNotFoundError: No module named ‘aspose’

这意味着在当前的 Python 环境中未安装 Aspose.PDF 包。

使用以下方法修复：

pip install aspose-pdf

如果您使用虚拟环境，请确保在安装包之前已激活该环境。

错误：未找到输入 PDF

如果脚本找不到输入文件，请检查文件路径。

而不是：

"input.pdf"

使用绝对路径：

"C:/Users/YourName/Documents/input.pdf"

或者在 Linux/macOS 上：

"/home/user/documents/input.pdf"

错误：小册子输出不在预期顺序中

如果您使用自定义的左页和右页数组，请确保页码与源 PDF 中的页面匹配。

示例:

left_pages = [1, 5]
right_pages = [2, 3]

这些值应根据您所需的小册子展开方式进行选择。

错误：书签未出现

如果书签未在您的 PDF 查看器中显示，请检查查看器是否已启用书签面板。有些 PDF 查看器默认隐藏书签。

您还可以将文档页面模式设置为显示大纲：

document.page_mode = pdf.PageMode.USE_OUTLINES

在保存 PDF 之前添加此内容：

document.save(output_pdf)