进阶 xournalpp.github.io 2026-10-18 14:40:32 · 21 阅读
第12章 在 Xournal++ 中处理与批注 PDF 文件
第12章 处理 PDF 文件
Xournal++ 支持多种在 PDF 文件上进行批注的功能。
与外部 PDF 文件交互的主要方式,是将该 PDF 文件设置为日志(journal)的背景。
设置 PDF 文件为日志背景
要创建一个使用 PDF 文件作为背景的日志,可通过菜单选项「文件 > 批注 PDF」或「文件 > 打开」来实现。这将打开一个对话框,供你选择 PDF 文件,随后系统会创建一个以该 PDF 为背景的新日志。
注意
目前,Xournal++ 将日志文件(.xopp)与 PDF 文件分开存储。保存日志文件时,PDF 文件的绝对路径会被记录在 .xopp 文件中。这意味着,如果你将 .xopp 文件移至另一台计算机,或将 PDF 文件移动到其他位置,Xournal++ 将无法找到背景 PDF。出现这种情况时,打开日志文件会提示你指定 PDF 的新位置,或选择一个新的 PDF 文件。
为解决此问题,可以使用下文所述的 PDF 附加模式。
目前计划引入一种“打包”文件格式,将日志和 PDF 文件存储在同一个文件中。更多信息请参阅 issue 跟踪器中的这个 issue。 附加模式(Attach mode)¶ 如果你使用“文件 > 标注 PDF”创建新日志,可以勾选“将文件附加到日志”复选框来启用“附加模式”。为某个日志启用附加模式后,保存时 PDF 文件将始终被复制到 .xopp 文件所在的目录,即使 .xopp 文件被移动过也是如此。此外,日志文件会以相对路径记录 PDF 文件的位置。这意味着你可以放心“移动”带有 PDF 背景的 .xopp 文件,只要确保是通过“文件 > 另存为”来移动即可! 注意(Bug) 在 Xournal++ 1.1.1 及更早版本中,存在一个 bug:加载时附加模式的设置不会被记住。该 bug 已在 Xournal++ 1.1.2 中修复。 浏览 PDF 文件¶ 如果 PDF 文件包含目录(table of contents),侧边栏的“大纲”标签页会显示该目录。点击“大纲”标签页中的某个条目,画布会跳转到对应的页面。 日志与 PDF 背景的关系¶ 受 Xournal++ 工作方式的限制,修改日志页面或修改背景 PDF 文件时存在以下几点限制: 由于 Xournal++ 将背景 PDF 文件单独处理,更改背景 PDF 可能导致标注与背景 PDF“失去同步”。例如,如果背景 PDF 中删除了某些页面,日志文件中仍会包含引用这些已删除页面的页面。Xournal++ 不会删除这些页面上的标注,但这些(已被删除的)页面将不再被渲染。 如果背景 PDF 文件中添加了新页面,Xournal++ 不会自动插入这些新页面,必须通过“日志 > 追加新 PDF 页面”菜单项手动插入到日志中。 搜索 PDF 文本¶ 要搜索 PDF 背景页面中的文本,可以使用“编辑 > 搜索”或快捷键 CtrlF。这会打开一个搜索框,让你在所有 PDF 页面中查找指定文本。 与 PDF 页面交互¶ 提示 此功能仅在 nightly 版本中可用。 可以使用 PDF Toolbox 功能与背景 PDF 页面交互。该功能通过以下工具提供: 选择线性 PDF 文本(Select Linear PDF Text):选择 PDF 中成行的文本 矩形选择 PDF 文本(Select PDF Text in Rectangle):用矩形光标选择 PDF 中的文本 更多信息请参阅 PDF Tools 页面。 导出为 PDF¶ 可以通过“文件 > 导出为 PDF”菜单项,以常规方式导出日志文件及其 PDF 背景。 受 Xournal++ 处理 PDF 文件方式的限制,导出时存在以下几点限制: 将标注导出为 PDF 后,PDF 文件中的标注将无法编辑,因为 PDF 格式本身并不是为编辑而设计的。 Xournal++ 的 PDF 导出不保留 PDF 文件内置的标注,例如弹出式注释和表单。 导出时不允许覆盖背景 PDF。因为覆盖背景 PDF 会导致日志中的标注与(新覆盖的)背景 PDF 的实际内容不一致。关于这个问题的更详细讨论,请参阅这个 issue。
为解决此问题,可以使用下文所述的 PDF 附加模式。
目前计划引入一种“打包”文件格式,将日志和 PDF 文件存储在同一个文件中。更多信息请参阅 issue 跟踪器中的这个 issue。 附加模式(Attach mode)¶ 如果你使用“文件 > 标注 PDF”创建新日志,可以勾选“将文件附加到日志”复选框来启用“附加模式”。为某个日志启用附加模式后,保存时 PDF 文件将始终被复制到 .xopp 文件所在的目录,即使 .xopp 文件被移动过也是如此。此外,日志文件会以相对路径记录 PDF 文件的位置。这意味着你可以放心“移动”带有 PDF 背景的 .xopp 文件,只要确保是通过“文件 > 另存为”来移动即可! 注意(Bug) 在 Xournal++ 1.1.1 及更早版本中,存在一个 bug:加载时附加模式的设置不会被记住。该 bug 已在 Xournal++ 1.1.2 中修复。 浏览 PDF 文件¶ 如果 PDF 文件包含目录(table of contents),侧边栏的“大纲”标签页会显示该目录。点击“大纲”标签页中的某个条目,画布会跳转到对应的页面。 日志与 PDF 背景的关系¶ 受 Xournal++ 工作方式的限制,修改日志页面或修改背景 PDF 文件时存在以下几点限制: 由于 Xournal++ 将背景 PDF 文件单独处理,更改背景 PDF 可能导致标注与背景 PDF“失去同步”。例如,如果背景 PDF 中删除了某些页面,日志文件中仍会包含引用这些已删除页面的页面。Xournal++ 不会删除这些页面上的标注,但这些(已被删除的)页面将不再被渲染。 如果背景 PDF 文件中添加了新页面,Xournal++ 不会自动插入这些新页面,必须通过“日志 > 追加新 PDF 页面”菜单项手动插入到日志中。 搜索 PDF 文本¶ 要搜索 PDF 背景页面中的文本,可以使用“编辑 > 搜索”或快捷键 CtrlF。这会打开一个搜索框,让你在所有 PDF 页面中查找指定文本。 与 PDF 页面交互¶ 提示 此功能仅在 nightly 版本中可用。 可以使用 PDF Toolbox 功能与背景 PDF 页面交互。该功能通过以下工具提供: 选择线性 PDF 文本(Select Linear PDF Text):选择 PDF 中成行的文本 矩形选择 PDF 文本(Select PDF Text in Rectangle):用矩形光标选择 PDF 中的文本 更多信息请参阅 PDF Tools 页面。 导出为 PDF¶ 可以通过“文件 > 导出为 PDF”菜单项,以常规方式导出日志文件及其 PDF 背景。 受 Xournal++ 处理 PDF 文件方式的限制,导出时存在以下几点限制: 将标注导出为 PDF 后,PDF 文件中的标注将无法编辑,因为 PDF 格式本身并不是为编辑而设计的。 Xournal++ 的 PDF 导出不保留 PDF 文件内置的标注,例如弹出式注释和表单。 导出时不允许覆盖背景 PDF。因为覆盖背景 PDF 会导致日志中的标注与(新覆盖的)背景 PDF 的实际内容不一致。关于这个问题的更详细讨论,请参阅这个 issue。