Documentation – 小册子和 N-Up 布局

Python-Net: 创建 N-Up PDF 文档

Mon, 08 Jun 2026 00:00:00 +0000

N-Up 布局将 PDF 文档的多页以网格形式放置在单页上。此布局常用于打印演示文稿、讲义或报告，以便一次查看多页内容。

使用 Aspose.PDF for Python，开发者可以通过指定行数和列数快速创建 N-Up 文档，这决定了每个输出页上显示多少原始页面。

在此代码片段中，‘make_n_up’方法的 PdfFileEditor 类将输入 PDF 的页面排列成 2 × 2 的网格，这意味着四个原始页面会显示在输出文档的一页上。

在示例中，布局使用 2 行 2 列，每张纸产生四页：

打开源 PDF 文件。
创建一个 PdfFileEditor 实例。
指定 N-Up 布局的行数和列数。
生成一个合并页面的新 PDF。

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
from io import FileIO

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Create N-Up PDF Document
def create_nup_pdf_document(infile, outfile):
    # Create NUpMaker object
    nup_maker = pdf_facades.PdfFileEditor()
    # Make N-Up layout from input PDF file and save to output PDF file
    nup_maker.make_n_up(
        FileIO(infile), FileIO(outfile, "w"), 2, 2
    )  # 2 rows and 2 columns for N-Up layout

Aspose.PDF for Python via .NET 允许您使用 PdfFileEditor 类生成 N-Up 布局。’try_make_n_up’ 方法的工作方式类似于 make_n_up，但在操作失败时不会抛出异常，而是返回一个布尔值，指示该过程是否成功。

N-Up 布局使用由行和列定义的网格，将多个 PDF 页面安排在单个页面上。

’try_make_n_up’ 方法提供了一种更安全的执行此操作的方式，因为：

如果布局成功创建，它返回 True。
如果操作失败，它返回 False。
它不会用异常中断程序执行。

在下面的示例中，文档使用 2 × 2 网格排列，将每个输出页放置四个原始页。

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
from io import FileIO

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Create N-Up PDF Document
def try_create_nup_pdf_document(infile, outfile):
    # Create NUpMaker object
    nup_maker = pdf_facades.PdfFileEditor()
    # Make N-Up layout from input PDF file and save to output PDF file
    if not nup_maker.try_make_n_up(FileIO(infile), FileIO(outfile, "w"), 2, 2):
        print("Failed to create N-Up PDF document.")

Python-Net: 创建 PDF 小册子

Mon, 08 Jun 2026 00:00:00 +0000

在准备 PDF 打印时，创建小册子式文档是常见需求。在小册子布局中，页面会重新排列，以便打印并折叠后呈现正确的顺序。

使用 Aspose.PDF for Python，开发者可以轻松地将标准 PDF 转换为小册子，使用 PdfFileEditor class. ‘make_booklet’ 方法会自动重新组织输入文档的页面，并生成一个针对小册子打印优化的新 PDF。

打开现有的 PDF 文档。
创建一个 PdfFileEditor 实例。
使用 make_booklet 方法重新组织页面。
将输出保存为小册子就绪的 PDF 文件。

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
from io import FileIO

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Create PDF Booklet
def create_pdf_booklet(infile, outfile):
    # Create BookletMaker object
    booklet_maker = pdf_facades.PdfFileEditor()
    # Make booklet from input PDF file and save to output PDF file
    booklet_maker.make_booklet(FileIO(infile), FileIO(outfile, "w"))

此代码片段展示了如何使用 ‘try_make_booklet’ 方法 PdfFileEditor 类来重新排列页面以进行小册子打印，在操作失败时不抛出异常。

小册子布局会重新排列页面，使得打印并折叠后文档能够按正确顺序阅读。自动化此过程可确保结果一致，并消除手动重新排列页面的需求。

‘try_make_booklet’ 方法的工作方式类似于 ‘make_booklet’，但有一个重要的区别：

‘make_booklet’ 如果操作失败会抛出异常。
’try_make_booklet’ 返回 True 或 False，允许开发者更安全地管理错误。

打开现有的 PDF 文档。
创建一个 PdfFileEditor 实例。
尝试创建小册子。
处理结果。

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
from io import FileIO

import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def try_create_pdf_booklet(infile, outfile):
    # Create BookletMaker object
    booklet_maker = pdf_facades.PdfFileEditor()
    # Make booklet from input PDF file and save to output PDF file
    # The try_make_booklet method is like the make_booklet method,
    # except the try_make_booklet method does not throw an exception if the operation fails.
    if not booklet_maker.try_make_booklet(FileIO(infile), FileIO(outfile, "w")):
        print("Failed to create booklet.")