PDF Arranger 技术文档

PDF Arranger 技术文档

pdfarranger Small python-gtk application, which helps the user to merge or split PDF documents and rotate, crop and rearrange their pages using an interactive and intuitive graphical interface. 项目地址: https://gitcode.com/gh_mirrors/pd/pdfarranger

PDF Arranger 是一款基于Python和GTK的小型应用程序，专为用户提供了一个直观的交互界面来合并、分割PDF文档，并能够旋转、裁剪及重新排列页面。它作为 PikePDF 的前端应用，旨在简化PDF文件管理过程。以下内容将指导您完成从安装到使用的全过程。

安装指南

Windows 用户

您可以直接从 GitHub 发布页面下载适用于Windows的最新版本安装包进行安装。

Linux 和 BSD 包装

• 对于Debian系（如Ubuntu）：

  sudo apt-get install python3-pip python3-wheel python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-poppler-0.18 gir1.2-handy-1 python3-setuptools
  pip3 install --user --upgrade https://github.com/pdfarranger/pdfarranger/zipball/main
  

• Arch Linux用户：

  sudo pacman -S poppler-glib python-pip python-gobject gtk3 python-cairo libhandy
  

• Fedora系统：

  sudo dnf install poppler-glib python3-pip python3-gobject gtk3 python3-cairo python3-wheel python3-pikepdf python3-img2pdf python3-dateutil libhandy
  

• FreeBSD用户：

  sudo pkg install devel/gettext devel/py-gobject3 devel/py-pip graphics/poppler-glib textproc/py-pikepdf x11-toolkits/gtk30 x11-toolkits/libhandy
  

源码编译安装

开发者或高级用户可以通过以下步骤从源码编译安装：

1. 克隆项目代码:

   git clone https://github.com/pdfarranger/pdfarranger.git
   

2. 确保已满足依赖项。
3. 使用pip安装：

   pip3 install --user --upgrade .
   

对于需要图像文件导入功能的用户，还需单独安装img2pdf。

项目的使用说明

启动PDF Arranger后，您会被引导至一个简洁的界面，可以执行以下操作：

• 添加PDF文件: 通过菜单或拖放方式加入PDF文件。
• 页面操作: 可以选择页面进行移动、复制、删除、旋转等。
• 合并与拆分: 将多个PDF整合成一个文件，或从单个PDF中提取页面。
• 编辑页面: 支持裁剪和旋转页面。
• 保存: 编辑后的PDF可以保存回原文件或另存为新文件。

详细的功能指南可参考用户手册。

项目API使用文档

PDF Arranger本身是作为一个GUI工具设计的，没有公开的传统意义上的API供外部程序调用。不过，它利用了PikePDF和其他库处理PDF底层逻辑，如果您寻求在其他项目中实现类似功能，可以直接探索PikePDF或其他相关库提供的API。

项目更新与贡献

对于希望参与项目维护和开发的人员，应当遵循GitHub上的项目指示，包括运行本地副本、提交代码更改和翻译工作。记得，在进行翻译时要遵守上述指南，确保一致性和质量，但请注意，PDF Arranger的应用级接口并不直接提供API文档，而是专注于用户体验的优化。

pdfarranger Small python-gtk application, which helps the user to merge or split PDF documents and rotate, crop and rearrange their pages using an interactive and intuitive graphical interface. 项目地址: https://gitcode.com/gh_mirrors/pd/pdfarranger