python-docx笔记心得

最近考试系统项目来了一个需求，需要根据给出的模板，直接在后台批量输出试卷的word docx文档
于是看了看网上的包找到了：python-docx
官方文档那叫一个难读啊··（英语废）
所以把重要的功能总结一下
安装：python3 ：pip install python-docx

text的font，size，大小，颜色的设置

先说一下这个api中对于一个docx的组织情况
一个word文档，分为标题heading和paragraph等块级元素
paragraph 内部根据不同的文字格式，不同的字体，甚至不同的字体大小，粗体，斜体划分为一个个的内联块（也就是后面说的 run ）
这句话非常重要，这决定了之后想要编辑段落文字的所有格式，每一个不同格式都要添加一次run
可以说，不论你想要在docx中添加什么东西，这个东西都是封装在 run 这个最小单位内部的，它的格式，必须通过操作 run 来改变
举个栗子：以下为一个段落paragraph：

这是一个run，这是一个run，这也是一个run，

这还是一个run

和我们使用word不同，我们必须先添加一个run，并且赋给它一小段文字，然后再通过run的api来改变它的格式
实例：我们想要添加一个段落，并且把这段文字的字体的一部分设置为宋体另外一部分设置为微软雅黑并且将文字设置为11磅，黑色

from docx import Document
from docx.enum.text import WD_ALIGN_PARAGRAPH,WD_LINE_SPACING
from docx.shared import Pt
from docx.shared import RGBColor
from docx.shared import Inches
doc = Document()  #生成一个空的docx对象
doc.add_heading() #添加标题
p = doc.add_paragragh() #添加段落
run=p.add_run('这段文字是宋体，') 
run.font.name = u'宋体'
run._element.rPr.rFonts.set(qn('w:eastAsia'), u'宋体')
run=p.add_run('这段文字是微软雅黑') 
run._element.rPr.rFonts.set(qn('w:eastAsia'), u'微软雅黑')
run.font.size = Pt(11) #设置大小为11磅
run.font.color.rgb = RGBColor（0,0,0）#设置颜色为黑色
document.save（'demo.docx'）#保存到demo.docx，默认为工程目录下

效果：

image.png

添加图片

实际上，图片在docx中也被认为是一个run，和一段文字是一样看待的
所以插入图片也要先插入一个run，再设置run的内容为 picture

p = document.add_paragraph()
run = p.add_run()
run.add_picture(img.jpg)

另外，python-docx目前只能支持插入内联图片，没有办法插入https://exam-test.cecctm.com/media/images/detect/1111111.png
链接，关于内联图片，是指的存在本机的图片吗，而不是存在互联网上的图片，有懂得dalao求解答一下——

设置页面段落排版等

和上面不同，页面段落的排版，是在块级元素上进行操作的，
也就是需要对paragraph，heading等对象进行修改，但是如果牵扯到块级元素内部文字的大小，颜色等等，则仍然需要add_run(阴魂不散啊）
上面这段话听不懂没关系，看下例子
如果你想添加一个字体大小为24磅的标题，并且居中
假如你这样的话

from docx.enum.text import WD_ALIGN_PARAGRAPH,WD_LINE_SPACING
head = document.add_heading('这是标题'，level=1)#添加一级标题
head.alignment = WD_ALIGN_PARAGRAPH.CENTER#居中

你会发现，你没法把heading的文字"这是标题"四个字变为24磅了！因为你没有在heading里面添加run，如果你希望把它变为24磅，你必须这样：

from docx.enum.text import WD_ALIGN_PARAGRAPH,WD_LINE_SPACING
head = document.add_heading('level=1')#添加一级标题
run = head.add_run('这是标题')
run.font.size = Pt(24)
head.alignment = WD_ALIGN_PARAGRAPH.CENTER#居中

总之，是不能把文字直接放在高级块中的···不然是没有办法编辑的！

用户下载docx

output = '/main/media/paper_docx.docx'
resp = make_response(send_file(output))

响应为下载