基于模板替换的word文档自动生成

简介

word文档自动生成程序是一个根据用户提供的模板word文档以及一些必要的数据文件来渲染生成所要的word文档的工具。

关键词：批量word文档生成、word文档渲染、自动生成word

使用场景：

几种典型的可以采用该工具减少工作量和增加效率的场景。

（1）需要批量生成大量内容基本相同，仅少数信息有差别的word文档。例如生成大量员工的合同、工资单等；

（2）需要在word文档中插入某种指定的大量的数据，手动插入这些数据非常耗时；

（3）需要多次生成一类word文档，每次的word文档仅指定的数据内容改变，其他总体格式保持不变；

（4）根据实验数据等生成word报告，实验数据会发生变化，报告内容大体不变，每次有新的实验数据就需要重新写word报告；

（5）需要在word报告中批量插入大量的图片或者表格，图片在单独的目录下能按规则准备好，或者表格中的数据在excel中已经准备好。

使用方法：

用户准备word模板文件，并命名为template.docx

用户编写标签-内容文件，命名为labels.txt

将所有的附加依赖的数据文件，以及template.docx和labels.txt全部放在工作目录下

cmd窗口中执行程序

autoWord.exe 工作目录

例如执行程序所给样例：通用示例

在autoWord.exe程序和通用示例文件夹在同一个目录的情况下，在命令行窗口中执行

autoWord.exe  通用示例

或者指定通用示例文件夹所在的绝对路径

autoWord.exe  C:\\mytest\通用示例

由于本程序在命令行窗口中执行，无需界面操作，因此可供开发者在程序中调用，实现批量自动调用该工具。

本程序提供了多个样例供参考使用，参照用例的labels.txt和template.docx以及生成的product.word可以快速理解使用方法。

关于标签-内容文件labels.txt

它是由用户编写的，记录word中标记的标签，以及数据文件中要替换成的数据内容的文档。

labels.txt的编写需要遵守严格的规则。

关于模板word文档

用户用指定的规则符合在模板word文档中标记一些需要实际替换的文字或图片，表格等数据，这些标记将在程序执行后被替换成labels.txt中指定的内容。

参考样例

word的模板文档样例

详见：(272条消息) word文档-样例1-模板文档_xiyangxiaoguo的博客-CSDN博客

生成的word文档样例

详见：(272条消息) word文档-样例1-结果文档_xiyangxiaoguo的博客-CSDN博客

labels.txt

 如下文档：

#标签--内容对应文档
#==================标签解释======================
#标签不仅可以在Word模板中定义使用，也可以作为中间量在其他的标签中使用
#符号{{}}为内部标记，<>为属性标记，属性标记都是可以缺省的,[]和[[]]为数组标记,()为数组截取部分
##为行注释，#后面的内容将不被读取，常用于忽略某个标签
#:标签名 表示引用一个已经定义的标签的内容
#:.结构体成员名 表示引用一个结构体的某个成员的内容
#=值 表示使用一个具体的值

#以下标签头为特定含义的标签，用户需要严格遵循其语义使用
#image_**表示图片类标签
#array_**表示数组类标签
#pageSeparatedTable_**长表格标签
#table_**普通表格标签
#struct_** 多种复合内容块标签
#-----------------------------------------------

#普通文字替换标签
title={{机械工业}}
testSentence={{当前语句将放入目标文档标记处}}
tableCaption1={{核天体物理学}}
header={{核反应率}}
absorb1={{核燃料1}}
absorb2={{核燃料2}}
struct1={{核反应堆1}}
struct2={{核反应堆2}}
what={{中子}}
who={{光子}}
para2={{中子通量密度}}
subpara2={{核反应率}}
subsubpara2={{多普勒效应或多普勒展宽}}
dopulo={{多普勒展宽}}
alada={{pg,yd}}
zhoudeshi={{lualu}}
id={{100}}
chibu={{xxxxxxxxxx
yyyyyyyyyy}}
caption_label1={{这是一个行数目非常多的表格}}

#图片标签
#属性标签：height图片高度，width图片宽度
image_xx={{chart.png<height=50,width=100>}}
image_yy={{chart.png<height=50,width=50>}}
imageCaption_yy={{这是一个自动插入的图题注}}

#数组类型的数据
array_xx={{[['baba','caca','dili'],[1,2,3],[4,5,6],[1,2,3],[4,5,6],[1,2,3],[4,5,6],[1,2,3],[4,5,6]]}}
array_h1={{['baba','caca','dili']}}
array_h2={{['序号','苹果','梨']}}

#文件类型的数据
#文件类型的数据将自动读取出来并且把内容转化为普通文本标签，数组等类型
file_xx={{xyz.csv}} #csv和xlsx格式的文件将读取成为二维的数组类型
file_xyz={{xyz.xlsx}}

array_mp={{:file_xx}}

#长表格标签--长表格需要将表格拆解成多页，每页单独一个题注
#属性标签：horizontal_header水平表头，vertical_header垂直表头，caption题注，rows_perPage每页的行限制，usePageIndex使用分页指引(1/10)-当前页/总共页
pageSeparatedTable_xx={{:array_xx<horizontal_header:array_h1,caption:caption_label1,rows_perPage=4,usePageIndex=True>}}
#普通表格标签
table_xx={{:array_xx}}

table_reflect={{:array_xx<horizontal_header:array_h2>}}
array_mab={{:array_mp}}
#用array_**类型去存信息
array_kids={{[['这是第一个子表格','chart.png','图1','zhanghong','2023-01','PJ-RBDD'],['这是第一个子表格','chart.png','图2','liming','2023-01','PJ-RBDX']]}}
array_mem={{['label','image_1','title','author','date','code']}}

#用struct_**类型去解析复合的内容块信息
#属性标签：members内容块的项目成员,
#对于项目成员中的类型为图片的，请使用image_开头的名字作为该项目成员的名字，如image_apple
struct_kids={{:array_kids<members:array_mem>}} #用户可以在Word文档中通过 struct_kids.label去使用相应内容块的子内容

程序获取地址

链接：https://pan.baidu.com/s/1RXA5JzUb9fmB-EnwFWd8CA?pwd=ptty 
提取码：ptty