overview/overview-convert-html

镜像概述

该镜像为Overview平台（https://github.com/overview/overview-server%EF%BC%89%E6%8F%90%E4%BE%9BHTML%E5%92%8CRTF%E6%96%87%E4%BB%B6%E8%BD%AC%E6%8D%A2%E8%83%BD%E5%8A%9B%EF%BC%8C%E8%BE%93%E5%87%BA%E5%8C%85%E5%90%AB%E6%A0%87%E5%87%86%E5%8C%96%E7%9A%84JSON%E5%85%83%E6%95%B0%E6%8D%AE%E3%80%81%E6%96%87%E6%9C%AC%E5%86%85%E5%AE%B9%E3%80%81PDF%E6%96%87%E4%BB%B6%E5%8F%8A%E7%BC%A9%E7%95%A5%E5%9B%BE%EF%BC%8C%E6%BB%A1%E8%B6%B3%E6%96%87%E6%A1%A3%E5%A4%84%E7%90%86%E7%9A%84%E4%B8%80%E8%87%B4%E6%80%A7%E9%9C%80%E6%B1%82%E3%80%82

核心功能

• HTML转换：采用Firefox实现，兼顾转换质量与兼容性；
• RTF转换：通过Ted（原生RTF支持）+ Ghostscript组合，平衡速度与可靠性；
• 标准化输出：统一生成0.json（元数据，含wantOcr: false和contentType: application/pdf）、0.txt（文本内容）、0.blob（PDF文件）、0-thumbnail.jpg（缩略图）；
• 参数传递：保留输入JSON中的参数（如wantSplitByPage），仅调整特定元数据字段。

使用场景

适用于Overview平台内的文档处理场景，包括：

• 文档管理系统中的格式统一转换；
• 内容提取与预览图生成；
• 批量处理HTML/RTF文件以支持后续分析。

配置说明

无特殊配置项，需确保输入文件路径正确挂载至容器。

测试方法

1. 在test/test-XYZ目录下编写测试用例，包含input.blob（待转换文件）、input.json（转换参数）及预期输出文件（stdout、0.json、0.blob、0.txt、0-thumbnail.jpg）；
2. 执行docker build .运行测试，若实际输出与预期不符则测试失败；
3. 对于PDF、图片等格式，可通过容器生成预期文件：
   • 运行测试后，从失败容器中复制生成的文件到测试目录；
   • 示例命令：docker cp [容器ID]:/tmp/[测试临时目录]/0-thumbnail.jpg test/test-XYZ/。

部署示例

bash
# 挂载输入输出目录，执行转换（需根据实际参数调整）
docker run --rm \
  -v $(pwd)/input:/app/input \
  -v $(pwd)/output:/app/output \
  overview/overview-convert-html \
  /app/input/input.json