探索高质量的HTML到PDF转换:OpenHTMLtoPDF
简介
OpenHTMLtoPDF是一个纯Java库,它能渲染一部分格式良好的XML/XHTML(甚至一些HTML5)文档,利用CSS 2.1及其后续标准进行布局和格式化,并输出为PDF或图像文件。如果你正在寻找一个工具来生成美观的PDF文档,那么OpenHTMLtoPDF值得一试。
但是要注意,这个库并不适合处理现代的HTML5+内容,你需要专门针对它优化你的HTML文档,并利用其扩展的CSS特性来获得最佳效果。
开始使用
- 集成指南 - 获取Maven依赖并开始编码。
- 在线沙箱 - 可以在线测试并查看结果,现在还增加了日志功能!
- 模板库 - 针对此项目提供的MIT许可的模板库,更新至2021年9月21日。
- 展示文档 - PDF
- 文档wiki
- 模板作者指南 - PDF - 已弃用 - 相关信息已迁移到wiki
- 示例项目 - 美观简历生成器
与Flying Saucer的区别
- 使用了维护良好且LGPL兼容的PDFBOX作为PDF库,而不是iText。
- 支持生成符合辅助访问性标准(Section 508,PDF/UA,WCAG 2.0)的PDF。
- 支持创建PDF/A标准合规的PDF文档。
- 新的更快的渲染器使得在处理大型文档时速度可提升数倍。
- 更好地支持CSS3变换。
- 自动视觉回归测试PDF,包含大量端到端测试。
- 具有页面插入功能以防止内容截断。
- 内置SVG和MathML插件。
- 字体回退支持。
- 对于RTL和双向文档的支持有限。
- 不支持OpenType字体。
- 脚注支持。
- 更多差异,请参阅下面的变更日志。
许可证
OpenHTMLtoPDF遵循LGPL许可证分发。本项目本身授权于GNU Lesser General Public License版本2.1或更高,详情见许可证条款。您可以根据自己的需求自由使用OpenHTMLtoPDF,只要遵守许可证规定即可。
致谢
OpenHTMLtoPDF基于Flying-saucer项目构建,感谢那里的贡献者。代码也部分来源于neoFlyingSaucer。
常见问题
- OPENHTMLTOPDF兼容OpenJDK 8, 11 和 17(早期访问版)。至少需要Java 8才能运行。
- 不支持Android平台。
- 在Google App Engine(Java 8或更高环境)上应该可以使用。如遇到问题,请分享你的经验(Issue #179)。
- 没有实现流式列布局。(已经在RC12中实现)
- 不是一个web浏览器,不支持JavaScript和许多现代标准,比如flex和grid布局。
更改日志
最新的更改日志可参考项目仓库的提交记录。这里列出了一些主要更新:
版本1.0.11-SNAPSHOT
...
版本1.0.10(2021年9月13日)
...
关于更多详细的历史更改,包括新功能、修复和改进,以及安全更新,请参阅完整的更改日志。
OpenHTMLtoPDF以其卓越的技术特性和广泛的应用场景,为开发者提供了将HTML转换为专业PDF的强大工具。无论你是在设计电子书、报表,还是制作动态模板,这款库都能帮助你实现高效、准确的转换。所以,不要犹豫,立即尝试OpenHTMLtoPDF,并开启你的PDF制作之旅吧!