Python-docx 模块读写 Word 文档基础(一):创建文档、段落格式、字体格式设置方法
前言:1、创建 Word 文档及基础用法:2、段落格式设置:3、字体格式设置:结尾:【Python与Office】专栏前言:
从这篇博客开始,将开启新一个专栏【Python与Word】。该专栏将详细介绍Python的第三方包python_docx 操作 Office 办公软件 Word 文档的方法。
python-docx 模块简介:
安装方法:pip install python-docx
官方文档地址: python-docx 0.8.10
python-docx 模块集成了 Word 文档的读写功能,不像 python 的 xlwt 和 xlrd 模块操作 Excel 表格,一个辅助写,一个负责读,用起来还是很方便的。
【Python与Word】专栏简介:
本专栏也会分两个部分来讲解:基础接口(用法)详解,实例演练 。
基础接口讲解内容:
1、python-doxc模块新建(写) Word 文档(预计两篇博客);
2、python-doxc模块读取 Word 文档信息(预计一篇)。
实例演练:2-3 个实例。
本篇博客主要内容:
1、创建文档与基础操作;
2、文档段落格式设置;
3、字体格式设置。
1、创建 Word 文档及基础用法:
模块安装后,导入模块,新建 word 文档对象:
# 导入模块from docx import Documentdoc = Document() # 新建文档对象'''按模板新建 word 文档文件,具有模板文件的所有格式'''
新建了 Document 对象后就可以用它开始工作了:
# 增加标题:doc.add_heading('标题',1)'''add_heading(self, text="", level=1):'''# 段落正文par = doc.add_paragraph('第一个段落:')print(par) # <docx.text.paragraph.Paragraph object at 0x000000000A889F08>'''add_paragraph(self, text='', style=None):返回一个 Paragraph 段落对象'''# 在段落中添加文字run_ = par.add_run('段落文字')print(run_) # <docx.text.run.Run object at 0x000000000B2D31C8>'''add_run(self, text=None, style=None):返回一个 run 对象'''
解析:
以上代码,在文档中增加了一个标题、一个段落并在段落中增加了文字。以上三个方法都会返回相应的对象,以便后续的一些操作。
其他一些常用方法:(在文档中增加图片、表格)
# 增加图片pic_par = doc.add_picture('1.png')'''add_picture(self, image_path_or_stream, width=None, height=None):返回一个 InlineShape 对象'''print(pic_par) # <docx.shape.InlineShape object at 0x000000000B2F11C8># 增加表格table = doc.add_table(2,3)'''add_table(self, rows, cols, style=None):返回一个表格对象 '''print(table) # <docx.table.Table object at 0x000000000B302688># 保存文件doc.save('test.docx')
注:本篇博客会对 段落 run 对象进行详细讲解,增加图片、表格方法将会放在下一篇博客里介绍。
以上操作后,文件预览:
2、段落格式设置:
add_heading 方法:
# 增加分页符doc.add_page_break()# 增加标题 API 分析for i in range(0,10):exec ("doc.add_heading('标题%s',%s)" % (i,i))# 只能设置 0-9 级标题
add_heading 方法:是在Word 文档中增加标题,也就是Word文档中的这些快捷窗口:
0 - 9 级标题文件设置预览:
新建一个段落,并对段落格式进行设置:
1、段落文字对齐设置:
# 增加分页doc.add_page_break()par2 = doc.add_paragraph('第二个段落文本:麻烦给我的爱人来一杯MojIto,''我喜欢阅读她微醺时的眼眸,而我的咖啡,糖不用太多,''这世界已经因为她甜得过头,没有跟她笑容一样浓郁的雪茄,''就别浪费时间介绍收起来吧,拱廊的壁画,旧城的涂鸦,''所有色彩都因为她说不出话。')# Paragraph 段落格式设置# 段落对齐设置:# 导入对齐选项from docx.enum.text import WD_ALIGN_PARAGRAPH# 设置段落文本右对齐par2.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.RIGHT'''可选项有:'LEFT', 0, 'left', 'Left-aligned''CENTER', 1, 'center', 'Center-aligned.''RIGHT', 2, 'right', 'Right-aligned.''JUSTIFY', 3, 'both', 'Fully justified.''DISTRIBUTE', 4, 'distribute', 'Paragraph characters are distrib''uted to fill the entire width of the paragraph.''JUSTIFY_MED', 5, 'mediumKashida', 'Justified with a medium char''acter compression ratio.''JUSTIFY_HI', 7, 'highKashida', 'Justified with a high character'' compression ratio.''JUSTIFY_LOW', 8, 'lowKashida', 'Justified with a low character ''compression ratio.''THAI_JUSTIFY', 9, 'thaiDistribute', 'Justified according to Tha''i formatting layout.''''# 获取段落设置的对齐方式print(par2.alignment)
2、段落缩进设置:
# 段落缩进:# 导入缩进单位from docx.shared import Inches,Pt# 左缩进,0.5 英寸par2.paragraph_format.left_indent = Inches(0.5)# 右缩进,20 磅par2.paragraph_format.right_indent = Pt(20)# 首行缩进par2.paragraph_format.first_line_indent = Inches(1)
3、段落间距设置:
# 行间距# par2.paragraph_format.line_spacing = Pt(20) # 20 磅par2.paragraph_format.line_spacing = 1.5 # 1.5倍行距 单倍行距 1.0"当line_spacing设置为长度值时表示绝对距离,""设置为浮点数时表示行高的倍数"# 段前间距par2.paragraph_format.space_before = Pt(5)# 段后间距par2.paragraph_format.space_after = Pt(10)# 设置段落内部文字在遇到需分页情况时处理状态par2.paragraph_format.keep_together = True # 段中不分页par2.paragraph_format.keep_with_next = True # 与下段同页par2.paragraph_format.page_break_before = True # 段前分页par2.paragraph_format.widow_control = True # 孤行控制
以上段落设置方法,其实对应Word文档中的段落设置方法:
以上代码运行后文件效果截图:
注:以上设置的段落格式,也均可获取到设置值,如:
# 获取段落的左缩进,首行缩进,段前间距:l_space = par2.paragraph_format.left_indenth_space = par2.paragraph_format.first_line_indentb_space = par2.paragraph_format.space_beforeprint(l_space,h_space,b_space) # 打印结果# 457200 914400 63500
3、字体格式设置:
首先明确一个概念:
python-docx 模块中,paragraph 段落是一个块对象,可以理解为是一个容器。run 对象也是一个块对象,可以理解为具有相同格式的一段文字集合。
放在 word 文档中简单理解就是,一个段落包含许多文字,同一段落的文字,也可以有不同的格式。
注意:用 add_paragraph() 方法添加段落时,如果写入了文本,就直接创建了一个 run。
测试一下上面的 paragraph 对象:
# 获取上面段落对象 所有 run 对象par2_run = par2.runsprint(par2_run) # 打印结果:# [<docx.text.run.Run object at 0x000000000B307048>]
字体格式设置:
# 新建一个段落,增加一段文字run_2 = doc.add_paragraph().add_run('这爱不落幕,忘了心事的国度,''你所在之处,孤单都被征服,''铁铸的招牌,错落着就像,''一封封城市献给天空的情书,''当街灯亮起,Havana漫步,''这是世上最美丽的那双人舞。')# 设置字体格式run_2.font.name = 'Times New Roman' # 注:这个好像设置 run 中的西文字体# 设置中文字体# 需导入 qn 模块from docx.oxml.ns import qnrun_2.font.element.rPr.rFonts.set(qn('w:eastAsia'),'楷体')# 设置字体大小run_2.font.size = Pt(14)# 设置加粗run_2.font.bold = True# 设置斜体run_2.font.italic = True# 设置字体颜色 需导入 rgb 颜色模块from docx.shared import RGBColorrun_2.font.color.rgb = RGBColor(255,55,55) # 红色# 设置下划线# run_2.font.underline = True# 设置轮廓线# run_2.font.outline = True# 设置阴影# run_2.font.shadow = True# 删除线# run_2.font.strike = True# 双删除线# run_2.font.double_strike = True# 设置下标# run_2.font.subscript = True# 设置上标# run_2.font.superscript = True
注: 1、注释掉的方法也都可以正常使用,之所以注释掉是因为设置太多格式,文字显示效果会很乱。 2、像设置段落格式一样,字体格式也可以被读取。
以上代码运行后,文件效果截图:
结尾:
以上就是本篇博客全部内容了,感谢阅读。
下一篇博客会详细介绍:word 文档中增加图片、表格,写入表格数据、设置格式等内容。
【Python与Office】专栏
该专栏会对 Python 的第三方模块,如:xlwt,xlrd,python-docx等,操作 Office 办公软件(Word Excel PPT)的方法进行详细讲解。同时也会搭配一些实例演练,一方面强化知识点的理解与运用,另一方面也希望能起到,引导读者进行思考:如何用 python 提高 offic 办公软件办公效率的作用。
感兴趣的朋友,可以点个关注或收藏。如在博客中遇到任何问题或想法,可留言或私信。
创作不易,你的支持是我最大的动力,感谢 !
如果觉得《Python-docx 模块读写 Word 文档基础(一):创建文档 段落格式 字体格式设置方法》对你有帮助,请点赞、收藏,并留下你的观点哦!