Skip to content

indexdoc/indexdoc-batch-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

简体中文 | English | ✨ 在线Demo

批量文档助手

批量文档助手是一款高效便捷的文档批量生成工具,支持上传Excel文件与Word文件,可通过Excel文件定义最终生成文档的文件名规则,以及Word模板中需替换的相关字段;在Word模板中,只需将待替换内容以“{列名}”(列名为Excel文件中的对应列名)的形式标注,完成设置后点击生成按钮,即可快速批量生成符合需求的文档,大幅节省手动编辑、替换文档的时间成本,提升文档生成效率。

Python Version GitHub Stars License: MIT

✨ 核心功能

  • 🚀 批量文档生成:基于 Excel 数据和 Word 模板,一键批量生成自定义文档,支持多字段精准替换

  • 📋 灵活命名规则:通过 Excel 列定义最终生成文档的文件名,支持组合列名、固定文本等命名方式

  • 📝 简单模板标注:Word 模板仅需以 {列名} 标注待替换内容,无需复杂语法,上手即用

  • 📱 轻量化设计:纯 Python 实现,无需复杂环境依赖,支持 Windows/macOS/Linux 多系统运行

  • 🔧 容错机制:内置数据校验、文件格式验证,支持异常提示与日志输出,避免生成失败

  • 🛠️ 自定义扩展:开放核心替换逻辑,支持二次开发(如新增文件格式、自定义替换规则)

🚀快速开始

环境准备

  • Python 3.10+、Tornado 6.0+、ClickHouse 22.0+
  • 浏览器:Chrome、Firefox、Edge等主流浏览器。
https://github.com/indexdoc/indexdoc-batch-generator.git
#快速安装依赖库
pip install -r requirements.txt

# 阿里镜像源
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

数据库文件目录

sql/create_ck_table.sql

启动服务

cd src  # 替换为server.py实际所在的文件夹路径
python.exe server.py

访问地址 本地访问:http://127.0.0.1:50003/public/batchDoc.html

📝 使用示例

点击右侧区域即可上传相应Excel/Word文件。点击样例下载可下载相应的样例文件。 主页1 点击全部生成后,即可按照Excel文件中的内容批量生成Word文件。 主页2 Excel文件中从第二列开始的列名与Word文件中 {} 中的内容相对应,点击全部生成后,每行的内容都会根据列名 填入Word文档中。

样例文件

excel示例文件 wrod示例文件

生成的文件示例如下:

生成的文件示例

常见问题

  1. 文档生成后占位符未替换:检查Excel列名与Word模板中的占位符列名是否完全一致(含大小写);
  2. 提示生成失败:检查Excel文件是否包含「文件名」列,或文件名是否包含特殊字符;
  3. 部分文档生成失败:查看对应行的数据是否完整,或Word模板是否损坏

📞 联系方式

About

批量文档助手是一款高效便捷的文档批量生成工具,支持上传Excel文件与Word文件,可通过Excel文件定义最终生成文档的文件名规则,以及Word模板中需替换的相关字段;在Word模板中,只需将待替换内容以“{列名}”(列名为Excel文件中的对应列名)的形式标注,完成设置后点击生成按钮,即可快速批量生成符合需求的文档,大幅节省手动编辑、替换文档的时间成本,提升文档生成效率。

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors