制式文档引擎

系统初始化中...

加载系统组件...
切换主题 音效

制式文档引擎

简介

制式文档引擎是一个用于处理 Word 文档模板的工具,可以帮助您提取文档中的占位符并使用数据替换它们。

主要功能:

  • 从 DOCX 文件中提取占位符
  • 使用 JSON 数据编译 DOCX 模板
  • 支持页眉、页脚、脚注等特殊元素
  • 提供 API 接口,方便集成到其他系统

技术实现:

  • 基于 Node.js 和 Express 构建的高性能服务器
  • 支持两种占位符格式:西式 {{placeholder}} 和中式 【占位符】
  • 智能检测跨 XML 标签的分割占位符并提供警告

服务器配置:

  • 默认运行于端口 2432
  • 支持 CORS 跨域请求,便于前端集成
  • 文件上传大小限制为 10MB
  • 提供同步的文件处理 API

从 DOCX 文件中提取占位符

上传一个 DOCX 文件,提取所有占位符(支持两种格式:{{placeholder}} 和 【中式】)。

支持的文档元素:主文档、页眉、页脚、脚注、尾注和批注。
提示:占位符是指文档中需要被替换的标记。系统会自动识别两种格式:
{{placeholder}}
【中式占位符】
下载示例测试文件
拖放文件到此处或点击选择
提取成功!

提取占位符 API

API 端点: POST /api/extract

上传 DOCX 文件,提取所有占位符。

cURL 示例

curl -X POST http://your-host:2432/api/extract \
-F "docxFile=@/path/to/your/template.docx"

响应示例

{
"placeholders": [
{
  "text": "姓名",
  "type": "western",
  "location": "document"
},
{
  "text": "日期",
  "type": "chinese",
  "location": "document"
}
],
"warnings": null
}

使用说明

在 Word 文档中使用以下格式的占位符:

{{placeholder}}
【中式占位符】

工作流程

  1. 创建模板:在 Word 中创建文档,并插入占位符。
  2. 提取占位符:上传模板,获取所有占位符列表。
  3. 准备数据:创建 JSON 数据,其中键名与占位符文本完全匹配(不包括括号)。
  4. 编译文档:上传模板和 JSON 数据,生成最终文档。
提示:
  • 占位符区分大小写,请确保 JSON 数据中的键名与占位符完全匹配。
  • 对于页眉和页脚中的占位符,需要使用特殊的 JSON 格式(见下方"编译模板"部分)。
  • 如果 JSON 数据中没有对应的键,占位符将保持不变。

编译 DOCX 模板

上传一个 DOCX 模板文件,并提供 JSON 数据来替换占位符。

支持的文档元素:主文档、页眉、页脚、脚注、尾注和批注。
使用说明:
  1. 先使用"提取占位符"功能确认文档中的所有占位符
  2. 准备 JSON 数据,键名与占位符文本完全匹配
  3. 上传模板并填写 JSON 数据
  4. 点击"编译文档"按钮生成新文档

注意:JSON 中没有对应键的占位符将保持不变

下载示例测试文件
拖放文件到此处或点击选择
编译成功!

编译模板 API

API 端点: POST /api/compile

上传 DOCX 模板文件和替换数据,生成编译后的文档。

cURL 示例

curl -X POST http://your-host:2432/api/compile \
-F "docxFile=@/path/to/your/template.docx" \
-F "data={\"姓名\":\"张三\",\"日期\":\"2023年5月1日\"}" \
-F "specialData={\"header1\":{\"标题\":\"我的文档\"},\"footer1\":{\"页码\":\"第 1 页\"}}" \
--output compiled.docx

参数说明

  • docxFile: DOCX 模板文件
  • data: 主文档占位符的 JSON 数据
  • specialData: 页眉、页脚等特殊元素的 JSON 数据
提示:

API 响应是一个二进制文件流,直接保存为 .docx 文件即可。