前言

在日常工作中，需要经常处理pdf文件，比如合并、切割、转换之类的操作，而目前使用的wps之类的软件，动不动就要收费开会员，作为Github爱好者，就在开源的世界寻找一款代替的软件，今天发现了一款强大的pdf处理项目Stirling-PDF。

Stirling-PDF介绍

Stirling-PDF 是一款功能强大的、本地托管的基于 Web 的应用程序，专为处理各种 PDF 操作任务而设计。它利用 Docker 实现简单部署，为用户提供了一个丰富的界面来对 PDF 文件执行各种操作。其关键设计原则是用户数据隐私，通过完全在客户端处理文件或在服务器上临时处理文件来实现，文件在操作和下载后会被删除。

Github项目地址：
https://github.com/Stirling-Tools/Stirling-PDF

Stirling-PDF目前支持40种语言，其中就包括中文：

官方地址：
https://www.stirlingpdf.com/

文档地址：
https://docs.stirlingpdf.com/

Stirling-PDF安装部署

部署 Stirling-PDF 的主要且推荐的方法是通过 Docker。然而，也可以使用 Gradle 从源代码构建应用程序。

1. Docker 部署：利用预构建的 Docker 镜像进行快速简便的设置。这是最常见的方法。

通过docker run的命令如下：

docker run -d \
  --name stirling-pdf \
  -p 8080:8080 \
  -v "./StirlingPDF/trainingData:/usr/share/tessdata" \
  -v "./StirlingPDF/extraConfigs:/configs" \
  -v "./StirlingPDF/customFiles:/customFiles/" \
  -v "./StirlingPDF/logs:/logs/" \
  -v "./StirlingPDF/pipeline:/pipeline/" \
  -e DOCKER_ENABLE_SECURITY=false \
  -e LANGS=en_GB \
  docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

通过docker compose的文件内容如下：

version: '3.3'
services:
  stirling-pdf:
    image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest
    ports:
      - '8080:8080'
    volumes:
      - ./StirlingPDF/trainingData:/usr/share/tessdata # Required for extra OCR languages
      - ./StirlingPDF/extraConfigs:/configs
      - ./StirlingPDF/customFiles:/customFiles/
      - ./StirlingPDF/logs:/logs/
      - ./StirlingPDF/pipeline:/pipeline/
    environment:
      - DOCKER_ENABLE_SECURITY=false
      - LANGS=en_GB

2. 从源代码构建：涉及使用 Gradle 编译 Java 应用程序，提供更多自定义选项，但需要开发环境。

构建步骤如下：
克隆 Stirling-PDF 仓库。
确保已安装兼容的 Java 开发工具包 (JDK) 和 Gradle。
导航到克隆仓库的根目录。
运行 Gradle 构建命令（通常是 ./gradlew build 或 gradle build）。这将编译代码并在 build/libs 目录中生成一个 JAR 文件（例如 Stirling-PDF.jar）。
使用 java -jar build/libs/Stirling-PDF.jar 运行应用程序。

3. Windows 可执行文件：lauch4jConfig.xml 文件的存在表明可以创建 Windows 可执行文件，这可能捆绑了 Java 应用程序。

我们下载一个可执行的exe，安装试用一下

双击打开可执行文件，进入安装步骤：

安装完成之后，打开软件，如下图：

我们可以点击右上方的地球，进行语言切换，我们切换到中文显示：

这样就看起来爽多了！

Stirling-PDF核心功能

Stirling-PDF 提供了一整套全面的页面操作功能，旨在有效地操作和管理 PDF 文档。这些工具允许用户执行常见的任务，例如合并、拆分、旋转和重组 PDF 文件中的页面。核心功能如下：

• 查看和修改 PDF：用于查看多页 PDF 的交互式 GUI，包括排序、搜索、注释、绘图以及添加文本/图像。

• 合并：将多个 PDF 文件合并成一个文档。

• 拆分：根据页码将 PDF 拆分成多个文件，或将所有页面单独提取出来。

• 重组：更改 PDF 中页面的顺序。

• 旋转：以 90 度为增量旋转页面。

• 移除页面：从 PDF 中删除特定页面。

• 多页布局：将 PDF 格式化，以便在单个新页面上显示多个原始页面。

• 缩放：按指定百分比调整页面内容的大小。

• 对比度调整：修改 PDF 页面的对比度。

• 裁剪：裁剪 PDF 页面的选定区域。

• 自动拆分：使用物理扫描的页面分隔符拆分 PDF。

• 提取页面：从现有文档的选定页面创建新的 PDF。
• PDF 转单页：将多页 PDF 转换为单个长页面。

• 叠加 PDF：将一个 PDF 放置在另一个 PDF 之上。
• 按章节拆分：根据检测到的章节或分段来划分 PDF。

并且Stirling PDF还提供了管道功能，提供流水线的配置，Stirling-PDF 中的流水线功能允许用户定义并对一个或多个文件执行一系列 PDF 操作。这提供了一种强大的方式来自动化重复性任务并创建自定义工作流。流水线功能的核心思想是将多个 PDF 操作链接在一起。用户无需手动逐个应用每个操作(例如，先压缩，然后添加水印，再转换为 PDF/A)，而是可以定义一个“流水线”，指定这些操作及其参数。然后，此流水线可以对一组输入文件执行，生成最终的输出文件。