captomd/electron-pdf

CaptoMD-electron-pdf

Express服务器包装，作为fraserxu/electron-pdf的服务实现

镜像概述和主要用途

CaptoMD-electron-pdf是一个基于Express的服务器包装服务，专门用于集成fraserxu/electron-pdf功能。其核心用途是通过接收包含HTML主文件及相关资源的ZIP包，生成高质量的PDF文档。

核心功能和特性

• PDF生成：接收包含HTML文件及资源的ZIP包，自动处理并生成PDF
• 页面自定义：支持通过CSS定义页面尺寸、边距和方向
• 渲染控制：通过特定JavaScript确保页面DOM完全加载后再生成PDF

使用场景和适用范围

适用于需要将HTML内容（含CSS样式、字体、图片等资源）转换为PDF文档的场景，如动态报告生成、自定义格式文档导出、网页内容存档等需求。

使用方法和配置说明

生成PDF

通过发送POST请求到服务端点生成PDF：

[POST] http://localhost:9645/
请求体：包含主HTML文件及资源的ZIP包（application/zip格式）

ZIP包结构示例：

index.html
├─ assets/
│  ├─ my-styles.css
│  ├─ fonts.css
│  ┕─ fonts/
│     ├─ font-a.woff2
│     ┕─ font-a.ttf
┕─ image.svg

注意：ZIP包中必须包含index.html作为主入口文件。

页面自定义

默认页面尺寸为Letter，可通过CSS自定义页面属性。在CSS文件中使用@page规则声明：

CSS
/* 基础页面设置 */
@page {
    size: 210mm 297mm; /* 页面尺寸（宽×高） */
    margin: 24mm 16mm; /* 页边距（上右下左） */
}

/* 第一页特殊设置 */
@page :first {
    size: A4 landscape; /* 横向A4 */
    margin: 50mm 16mm 24mm; /* 自定义边距 */
}

DOM Ready处理

为确保页面完全渲染后再生成PDF，必须在index.html的head部分包含以下JavaScript：

JS
<script>
    var eventEmitInterval = setInterval(function () {
        document.body.dispatchEvent(new Event('view-ready'));
    }, 25);

    document.body.addEventListener('view-ready-acknowledged', function () {
        clearInterval(eventEmitInterval);
    });
</script>

此脚本通过定期发送view-ready事件，直到服务确认接收（发送view-ready-acknowledged事件），确保页面资源加载完成。