邮件转PDF转换器使用教程

1. 项目介绍

本项目是一款可以将电子邮件文件（eml 或 msg 格式）转换为 PDF 文件的开源工具。它既可以作为库使用，也可以作为命令行工具或带有图形用户界面的桌面应用程序。转换过程是通过解析（和清理）MIME 结构，将其转换为 HTML，然后使用 wkhtmltopdf 将生成的 HTML 转换为 PDF 文件。此外，它还能处理内联图像、损坏的 MIME 头，并可以使用代理。

2. 项目快速启动

首先，确保你的系统中安装了完整的 Java 运行环境（JRE），而不是仅限命令行的版本。在 Debian 系统中，你需要安装 openjdk-11-jre。

接着，确保 wkhtmltopdf 可执行文件已经在你的系统路径（$PATH）中。

以下是一个快速启动的示例：

# 下载最新的jar文件并运行
java -jar emailconverter-2.1.1-all.jar example.eml

这里，example.eml 是你想要转换的电子邮件文件。如果你使用的是 jar 文件，确保 wkhtmltopdf 可执行文件在系统路径中。

3. 应用案例和最佳实践

转换电子邮件为PDF并包含附件名称

java -jar emailconverter-2.1.1-all.jar -aa example.eml

仅提取附件

java -jar emailconverter-2.1.1-all.jar -a example.eml

转换电子邮件为PDF并提取附件到指定目录

java -jar emailconverter-2.1.1-all.jar -a -ad /path/to/directory example.eml

不显示电子邮件头部信息

java -jar emailconverter-2.1.1-all.jar -hh example.eml

自定义PDF输出路径

java -jar emailconverter-2.1.1-all.jar -o /path/to/output.pdf example.eml

设置纸张大小和DPI

java -jar emailconverter-2.1.1-all.jar -s Letter -r 150 example.eml

使用代理

java -jar emailconverter-2.1.1-all.jar -p http://10.64.1.74:81 example.eml

4. 典型生态项目

目前，该项目没有列出具体的生态项目。不过，类似的电子邮件处理工具可以被集成到各种自动化工作流中，例如自动归档系统、电子邮件管理系统或客户服务工具中。开发者可以根据需要，将此工具作为模块集成到更大的系统中，以实现特定的功能需求。