joseco/docx-templates

基于Word模板的动态PDF生成器

一个高保真API服务，通过向Microsoft Word（.docx）模板注入动态JSON数据，实时生成自定义PDF文档。

该服务适用于自动化生成发票、证书、合同、邀请函、课程表和报告等文件，确保输出PDF与原始Word文件的布局、边距、表格等细节完全一致。

核心功能

• 动态数据注入：将模板中的占位符（如{{ client_name }}）替换为JSON数据中的对应值。
• 高保真PDF输出：精准保留Word文档的布局、边距、表格、自定义边框及页眉页脚。
• 自动格式转换：自动将JSON payload中的换行符（\n）转换为文档内的原生换行。
• 自定义品牌字体：支持导入自定义字体文件以匹配品牌风格。

运行容器方法

通过挂载模板和（可选）字体目录运行容器：

bash
docker run -d \
  -p 5000:5000 \
  -v /本地模板路径:/app/docs \
  -v /本地字体路径:/app/fonts \
  --name doc-generator \
  joseco/docx-templates

• 模板目录（/app/docs）：存放你的.docx模板文件。
• 字体目录（/app/fonts）：（可选）存放自定义.ttf或.otf字体文件。

API使用方法

接口：POST /generate

发送HTTP POST请求，携带包含替换变量的JSON payload。

请求头：

http
Content-Type: application/json

示例JSON payload：

json
{
  "template": "invoice-template.docx",
  "invoice_number": "INV-2026-0042",
  "date": "2026年6月6日",
  "client_name": "Acme公司",
  "items": "1. 网站开发服务\n2. 数据库迁移支持",
  "total_amount": "2500.00元"
}

• "template"字段为必填项，指定模板目录中的目标文件。
• JSON中的其他键值对将与模板中的占位符（如{{ invoice_number }}或{{invoice_number}}）匹配替换。

API响应：

返回生成的PDF二进制流。

💡 提示：使用Postman等工具测试时，选择“发送并下载”选项可直接保存为PDF文件。