Pdf Generator_知识管理 skill-PHP中文网

Pdf Generator

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

从Markdown、HTML、数据或代码生成专业PDF。支持报告、发票、合同等符合最佳实践的文档。

User 需要创建、生成或导出 PDF 文档

功能概述

User 需要创建、生成或导出 PDF 文档是一项面向实际任务的技能，主要用于代理处理多个源( 马克当、 HTML、 JSON、模板) 的文档生成、格式化、样式化和批量 p。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

适用场景

用户需要创建、生成或导出 PDF 文档。Agent 负责从多种来源（Markdown、HTML、JSON、模板）生成文档，并完成格式化、样式设置及批量处理任务。

适用范围

本技能仅限于：

提供 PDF 生成的代码范式与实现指导
讲解工具选型、面向打印的 CSS 编写方法以及文档结构设计原则
展示常见文档类型的参考示例

本技能绝不执行以下操作：

直接运行代码或生成文件
发起网络请求
访问用户工作目录以外的任何文件

所有代码示例仅为供用户自行实现所用的参考范式。

快速查阅

主题	文件
工具选型	`tools.md`
文档类型	`templates.md`
高级操作	`advanced.md`

核心规范

1. 选择合适的工具

输入源	推荐工具	原因
Markdown	pandoc	原生支持，自动生成目录（TOC），支持模板
HTML/CSS	weasyprint	CSS 支持最完善，无需 LaTeX 环境
数据/JSON	reportlab	编程式控制，精度高、灵活性强
纯文本	fpdf2	轻量级、速度快

默认推荐： 对大多数基于 HTML 的文档，优先选用 weasyprint。

2. 先结构，后样式

# 正确：语义化结构
html = """

  Report Title
  
    Summary
    Content...
  

"""

# 错误：以样式为先
html = "Report Title"

3. 显式控制分页

/* 在元素前强制分页 */
.new-page { page-break-before: always; }

/* 防止元素内部断页 */
.keep-together { page-break-inside: avoid; }

/* 标题后不孤行（避免标题单独出现在页尾） */
h2, h3 { page-break-after: avoid; }

4. 始终设置元数据

# weasyprint 示例模式
html = """


  Document Title
  

...
"""

5. 使用面向打印优化的 CSS

@media print {
  body {
    font-family: 'Georgia', serif;
    font-size: 11pt;
    line-height: 1.5;
  }
  
  @page {
    size: A4;
    margin: 2cm;
  }
  
  .no-print { display: none; }
}

6. 验证输出结果

生成任意 PDF 后，请执行以下检查：

检查文件大小（0 字节表示生成失败）
打开文件并确认页数是否正确
验证字体是否正常渲染

常见陷阱

陷阱	后果	修复方式
缺失字体	回退至系统默认字体	使用 Web 安全字体
图像路径为绝对路径	图像无法加载	改用相对路径
未指定页面尺寸	布局不可预测	显式设置 `@page { size: A4; }`
图像尺寸过大	生成 PDF 文件体积异常庞大	使用前对图像进行压缩