overview/overview-convert-text

镜像概述

本镜像为https://github.com/overview/overview-server%E5%B9%B3%E5%8F%B0%E6%8F%90%E4%BE%9B%E6%96%87%E6%9C%AC%E6%96%87%E4%BB%B6%E8%BD%AC%E6%8D%A2%E6%9C%8D%E5%8A%A1%EF%BC%8C%E8%83%BD%E5%A4%9F%E5%B0%86%E8%BE%93%E5%85%A5%E7%9A%84%E6%96%87%E6%9C%AC%E6%96%87%E4%BB%B6%E8%BD%AC%E6%8D%A2%E4%B8%BA%E6%8C%87%E5%AE%9A%E6%A0%BC%E5%BC%8F%E7%9A%84%E8%BE%93%E5%87%BA%E6%96%87%E4%BB%B6%EF%BC%8C%E9%80%82%E9%85%8D%E5%B9%B3%E5%8F%B0%E7%9A%84%E5%A4%84%E7%90%86%E6%B5%81%E7%A8%8B%E3%80%82

核心功能

1. 固定输出文件：始终生成0.json、0.txt、0.blob和0-thumbnail.jpg四类文件；
2. 字符集检测：通过https://github.com/chardet/chardet%E7%8C%9C%E6%B5%8B%E5%AD%97%E7%AC%A6%E9%9B%86%EF%BC%8C%E8%8B%A5%E9%9C%80%E7%A1%AE%E4%BF%9D%E5%87%86%E7%A1%AE%E6%80%A7%E5%BB%BA%E8%AE%AE%E5%B0%86%E6%96%87%E6%9C%AC%E7%BC%96%E7%A0%81%E4%B8%BAUTF-8%EF%BC%9B
3. PDF生成：使用ReportLab生成PDF，兼顾处理速度与功能完整性；
4. 语法高亮：基于Pygments实现语法高亮，依赖Overview传递的contentType参数；
5. 缩略图生成：通过pdftocairo生成JPG格式缩略图，优化处理效率。

使用场景

适用于Overview平台处理用户上传的文本文件，将其转换为平台所需的PDF、文本及缩略图格式，支持后续的内容展示与分析。

配置说明

• 字符集要求：若需保证字符集检测100%准确，需将输入文本编码为UTF-8；
• 字体支持：当前仅嵌入Noto Sans Mono字体，后续将优化以支持更多语言字符。

测试方法

1. 在test/test-XYZ目录下编写测试文件（含input.blob、input.json及预期输出文件）；
2. 执行docker build .运行测试，对比实际输出与预期文件是否一致；
3. 若PDF、图片等格式输出不一致，可通过Docker容器复制生成的文件更新预期测试用例。

部署示例

bash
# 挂载输入输出目录的部署示例
docker run --rm \
  -v $(pwd)/input:/app/input \
  -v $(pwd)/output:/app/output \
  overview/overview-convert-text