overview/overview-convert-pdf

Overview PDF处理镜像

镜像概述

该镜像用于为https://github.com/overview/overview-server%E5%B9%B3%E5%8F%B0%E5%87%86%E5%A4%87%E5%8F%AF%E6%9F%A5%E7%9C%8B%E7%9A%84PDF%E6%96%87%E4%BB%B6%E3%80%82%E9%80%9A%E8%BF%87%E5%A4%84%E7%90%86PDF%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%85%B6%E5%8C%85%E5%90%AB%E6%96%87%E6%9C%AC%E5%86%85%E5%AE%B9%E5%92%8C%E7%BC%A9%E7%95%A5%E5%9B%BE%EF%BC%8C%E4%BB%A5%E4%BE%BFOverview%E5%B9%B3%E5%8F%B0%E8%83%BD%E5%A4%9F%E6%AD%A3%E7%A1%AE%E5%B1%95%E7%A4%BA%E3%80%82

核心功能与特性

• 文本与缩略图提取：处理PDF文件，提取文本内容并生成缩略图
• 页面拆分支持：当输入JSON的wantSplitByPage为true时，按页面拆分PDF，每个输出文档包含metadata.pageNumber（从1开始编号）
• 元数据自动填充：若输入metadata缺少以下标签且PDF可提供相关数据，将自动填充到输出文档（或拆分后的每一页文档）：
  • Title（标题）
  • Author（作者）
  • Subject（主题）
  • Keywords（关键词）
  • Creator（创建文档的程序）
  • Creation Date（创建日期）
  • Modification Date（修改日期）
• 高效处理：使用PDFium工具，具有启动快速、处理高效的特点（每个输入文件启动独立进程，单个文件内存错误不影响后续处理）
• 性能目标：在普通机器上，对小型PDF：
  • 提取文本和缩略图耗时<0.1秒
  • 按页生成PDF（含文本和缩略图）耗时<0.2秒

使用场景与适用范围

适用于Overview平台的PDF预处理流程，特别是需要将原始PDF转换为可展示格式的场景，包括但不限于：

• 文档管理系统中的PDF预览准备
• 需要提取PDF文本内容和元数据的应用
• 需按页面拆分PDF并保留元数据的场景

详细使用方法与配置说明

输入参数

• wantSplitByPage：布尔值，控制是否按页面拆分PDF。true时输出每页独立文档并添加metadata.pageNumber
• metadata：元数据对象，包含PDF的描述信息，若缺少上述指定标签将自动从PDF中提取补充

处理流程

1. 接收输入PDF文件和配置JSON
2. 提取PDF文本内容和生成缩略图
3. 根据wantSplitByPage参数决定是否按页面拆分
4. 检查并填充缺失的元数据字段
5. 输出处理后的文档（单个PDF或多页拆分文档）

开发指南

前提条件

• 安装Docker-CE（参考Docker官方安装文档）

构建镜像

• 基本构建：

  bash
  docker build .
  

• 测试构建（编译二进制文件并运行单元测试）：

  bash
  docker build --target=test .
  

• 生产构建（生成最小化镜像）：

  bash
  docker build --target=production .