overview/overview-convert-office

overview/overview-convert-office 镜像说明

镜像概述

本镜像用于为 https://github.com/overview/overview-server 平台转换办公文件，基于 LibreOffice 和 QPDF，通过自定义C++代码结合 LibreOfficeKit 实现高效转换，同时保障转换过程的安全性。

核心功能

1. 办公文件转换：将各类办公文件（如ODT、DOC等）转换为PDF格式；
2. 元数据保留：保留输入文档的元数据（标题、作者、主题、关键词、创建日期、修改日期）并写入输出PDF；
3. 安全机制：每次转换后重置LibreOffice配置目录，清除临时数据，避免数据残留；
4. 固定输出格式：始终输出 0.json（含 wantOcr:false）和 0.blob 文件，便于后续处理。

使用场景

• 作为Overview平台的核心组件，处理用户上传的办公文件转换需求；
• 需要安全、高效转换办公文件并保留元数据的独立应用场景。

配置与部署

Docker Run 示例

bash
docker run --rm \
  -v /本地输入路径:/app/input \
  -v /本地输出路径:/app/output \
  overview/overview-convert-office

测试方法

1. 在 test/test-* 目录下创建测试用例，包含 input.blob、input.json 及预期输出文件（stdout、0.json、0.blob）；
2. 执行 docker build . 自动运行测试，验证转换结果是否与预期一致；
3. 若PDF结果存在差异，可通过容器复制实际输出文件更新预期值（参考原文档测试步骤）。