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-Shuffler 的精神，旨在提供更活跃的开发维护环境。本指南将带你逐步完成从零开始安装至成功运行PDF Arranger的全过程，适合所有水平的用户。

1. 项目基础介绍与编程语言

项目名称: PDF Arranger
主要编程语言: Python
关键技术与框架: GTK+, PikePDF

2. 关键技术和框架简介

GTK+: 是一个用于创建图形用户界面的工具包，支持多种操作系统，包括Linux、Windows和Mac OS X。
PikePDF: 是一个处理PDF文件的库，提供了读写、修改PDF的能力，是PDF Arranger背后的核心力量。

3. 准备工作与详细安装步骤

对于Windows用户：

安装Python: 确保安装了Python 3.x（推荐最新版本），可以从Python官网下载并安装。
安装Pip: 如果安装Python时未自动添加Pip，需单独安装。打开命令提示符，输入python get-pip.py或根据系统指示进行安装。
安装依赖: 运行以下命令以安装必要的依赖项（此步骤可能需要额外查找适用于Windows的相应包）：
```
pip install --upgrade pikepdf img2pdf
```
安装PDF Arranger: 直接通过命令行执行以下指令来安装（确保已克隆或下载了项目源代码）：
```
pip install -e path\to\pdfarranger
```

对于Linux（以Debian系为例）：

更新软件包列表:
```
sudo apt update
```

安装依赖:

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

安装PDF Arranger: 使用pip安装：

pip3 install --upgrade git+https://github.com/pdfarranger/pdfarranger.git

对于开发者和定制需求：

获取源码:

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

构建与运行: 进入项目目录并执行：

cd pdfarranger
python3 setup.py build
python3 -m pdfarranger

注意事项：

在非标准环境或特定操作系统下，可能需要手动解决依赖问题。
对于MacOS用户，因涉及GTK3和gettext的配置较为复杂，建议查看项目的官方文档或GitHub上的Win32.md文件（尽管命名误导，但有时会包含跨平台相关信息）以获取具体步骤。
安装过程中遇到任何Python库版本不兼容的问题，可尝试指定版本安装或者寻求社区的帮助。

遵循上述步骤，您应能顺利安装并开始使用PDF Arranger，享受便捷的PDF文档管理体验。