最全总结 | 聊聊 Python 办公自动化之 Word(上)

AirPython 2020-11-12 22:00:32
总结 Python 聊聊 最全 全总


image

1. 前言

日常自动化办公中,使用 Python 真的能做到事半功倍!

在上一个系列中,我们对 Python 操作 Excel 进行了一次全面总结

最全总结 | 聊聊 Python 办公自动化之 Excel(上)

最全总结 | 聊聊 Python 办公自动化之 Excel(中)

最全总结 | 聊聊 Python 办公自动化之 Excel(下)

从本篇文章开始,我们继续聊聊另外一种常见的文档格式:Word

2. 准备

Python 操作 Word 最常见的依赖库是:python-docx

所以,在开始操作之前,我们需要在虚拟环境下安装这个依赖库

# 安装依赖
pip3 install python-docx

3. 写入实战

我们需要了解一个 Word 文档的页面结构

它们分别是:

  • 文档 - Document

  • 章节 - Section

  • 段落 - Paragraph

  • 文字块 - Run

经常操作的数据类型包含:段落、标题、列表、图片、表格、样式

首先,使用 Document 创建一个文档对象,相当于创建一个空白文档

from docx import Document
# 1、新建一个空白文档
doc = Document()

然后,就可以往文档中写入数据了

使用文档对象的 add_heading(text,level) 方法可以写入标题

其中,第 1 个参数为标题内容,第 2 个参数代表标题的级别

比如:分别写入一级标题、二级标题、三级标题

# 2、新增内容
# 2.1 标题
# 分别写入一个一级标题,一个二级标题,一个三级标题
doc.add_heading('一级标题', 0)
doc.add_heading('二级标题', 1)
doc.add_heading('三级标题', 2)

段落 Paragraph 包含 3 类,分别是:

  • 普通段落

  • 自定义样式的段落

  • 引用段落

默认情况下,使用文档对象的 add_paragraph(text,style) 方法来添加一个段落

普通段落:假如第二个参数 style 没有传入,则代表添加一个普通的段落

引用段落:对于引用段落,只需要指定段落样式为 Intense Quote 即可

# 2.2.1 新增普通段落
doc.add_paragraph("我是一个普通段落。")
# 2.2.3 新增一个引用段落
# 只需要指定样式为:Intense Quote
doc.add_paragraph('--我是一个引用段落--', style='Intense Quote')

自定义样式的段落:这里有 2 种实现方式

分别是:

  • 创建一个空的段落对象,增加文字块 Run 的时候,同时指定字体样式

  • 使用文档对象创建一个新的样式(或已经存在的样式),然后添加段落的时候,设置到第二个参数中

考虑到样式的样式的复用性,第 2 种方式可能更实用

对应的方法是:

document.styles.add_style(style_name,type)

以第 2 种实现方式为例,新增一个自定义样式的段落,设置段落的字体名称、大小、颜色、是否加粗、对齐方式等

PS:第 1 种实现方式,文末源码会提供

该方法第 2 个参数用来指定样式类型,包含 3 种

分别对应关系如下:

  • 1:段落样式

  • 2:字符样式

  • 3:表格样式

def create_style(document, style_name, style_type, font_size=-1, font_color=None, font_name=None, align=None):
"""
创建一个样式
:param align:
:param document:
:param style_name: 样式名称
:param style_type: 样式类型,1:段落样式, 2:字符样式, 3:表格样式
:param font_name:
:param font_color:
:param font_size:
:return:
"""
if font_color is None:
font_color = []
# 注意:必须要判断样式是否存在,否则重新添加会报错
style_names = [style.name for style in document.styles]
if style_name in style_names:
# print('样式已经存在,不需要重新添加!')
return
font_style = document.styles.add_style(style_name, style_type)
# 字体大小
if font_size != -1:
font_style.font.size = Pt(font_size)
# 字体颜色
# 比如:[0xff,0x00,0x00]
if font_color and len(font_color) == 3:
font_style.font.color.rgb = RGBColor(font_color[0], font_color[1], font_color[2])
# 对齐方式
# 注意:段落、表格才有对齐方式
if style_type != 2 and align:
font_style.paragraph_format.alignment = align
# font_style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER
# font_style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.LEFT
# font_style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.RIGHT
# 中文字体名称
if font_name:
font_style.font.name = font_name
font_style._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)
return font_style

需要注意的是,新添加的样式的时候,必须先判断样式名称是否存在,否则会报错

最后,添加段落的时候,将上面创建的样式传入到第 2 个参数中即可

使用 add_paragraph() 方法添加一个段落,返回值为一个段落对象

image

该对象同样可以使用 add_run(text,style) 方法,在段落后追加文字块 Run 并指定样式

# 1/段落样式
style_paragraph = create_style(document=doc, style_name="style2", style_type=1, font_size=30,
font_color=[0xff, 0x00, 0x00])
# 2/字符样式
style_string = create_style(document=doc, style_name="style3", style_type=2, font_size=15,
font_color=[0x00, 0xff, 0x00])
# 3/表格样式
# 对齐方式为:居中
style_table = create_style(document=doc, style_name="style4", style_type=3, font_size=25,
font_color=[0x00, 0x00, 0xff], align=WD_PARAGRAPH_ALIGNMENT.CENTER)
current_paragraph = doc.add_paragraph("我是一个自带样式的段落(方式二)!!!", style_paragraph)
# 字符样式
current_paragraph.add_run("【段落2中的部分字符】", style_string)

Word 文档中,有序列表和无序列表也比较常用

事实上,和添加段落类似,添加列表同样是使用文档对象的 add_paragraph() 方法,指定不同的样式 style 来添加

其中,

  • 有序列表:List Number

  • 无序列表:List Bullet

def add_list(document, data, isorder):
"""
将列表数据添加到无序列表/有序列表中
:param document: 文档对象
:param data: 列表数据
:param isorder: 是否有序列表
:return:
"""
# 无序列表
if not isorder:
for item in data:
document.add_paragraph(item, style='List Bullet')
else:
# 有序列表
for item in data:
document.add_paragraph(item, style='List Number')
# 2.3 列表
# 2.3.1 无序列表
add_list(doc, ["无序-Item1", "无序-Item2", "无序-Item3"], False)
# 2.3.2 有序列表
add_list(doc, ["有序-Item1", "有序-Item2", "有序-Item3"], True)

接下来,我们看看如何在文档中插入图片

使用方法:

add_picture(image,widht,height)

其中,

  • 第 1 个参数代表图片路径或者图片流(网络图片)

  • 第 2、3 个参数用于设置图片的宽、高

需要注意的是,如果没有显式指定宽高,则以图片原生尺寸展示;如果仅设置了其中一个,则会按照设置的一个做等比缩放显示

写入本地图片很简单

def add_local_image(doc, image_path, width=None, height=None):
"""
增加本地图片到Word文档中
:param doc:
:param image_path:
:param width:
:param height:
:return:
"""
doc.add_picture(image_path, width=None if width is None else Inches(width),
height=None if height is None else Inches(height))
# 2.4.1 插入本地图片
add_local_image(doc, './1.png', width=2)

对于网络图片,我们需要先通过网络图片地址,获取图片字节流,传入到第一个参数中即可

import ssl
from io import BytesIO
def get_image_data_from_network(url):
"""
获取网络图片字节流
:param url: 图片地址
:return:
"""
ssl._create_default_https_context = ssl._create_unverified_context
# 获取网络图片的字节流
image_data = BytesIO(urlopen(url).read())
return image_data
def add_network_image(doc, image_url, width=None, height=None):
"""
增加本地图片到Word文档中
:param doc:
:param image_url:
:param width:
:param height:
:return:
"""
# 获取图片流
image_data = get_image_data_from_network(image_url)
doc.add_picture(image_data, width=None if width is None else Inches(width),
height=None if height is None else Inches(height))
# 2.4.2 插入网络图片
url = '图片URL地址'
add_network_image(doc, url, width=3)

最后,我们看看如何在文档中插入表格

使用方法:

add_table(row_num,column_num,style=None)

返回值:表格对象 <class 'docx.table.Table'>

其中,

  • 第 1 个参数:表格的行数目

  • 第 2 个参数:表格的列数目

  • 第 3 个参数:表格的样式

使用行/列索引,可以获取表格中某一行/列所有的单元格对象组成的列表

# 添加一个table表格
table = doc.add_table(***)
# 通过行/列索引,获取某一行/列的所有单元格对象
# 第一行所有单元格对象列表
head_cells = table.rows[0].cells

另外,表格对象使用 add_row()、add_column() 方法可以追加一行/列

以指定表头、表数据,插入一张表为例

def add_table(doc, head_datas, datas, style=None):
"""
新增一个表格
:param doc:
:param head_datas: 表头
:param datas: 数据
:param style:
:return:
"""
# 新增一个表格
# 表格所有样式大全:https://blog.csdn.net/ibiao/article/details/78595295
# 默认样式为:Table Grid
table = doc.add_table(rows=1, cols=len(head_datas), style=("Table Grid" if style is None else style))
# 第一行所有单元格对象列表
head_cells = table.rows[0].cells
# 写入数据到表头中
for index, head_item in enumerate(head_datas):
head_cells[index].text = head_item
# 遍历数据并写入数据
for data in datas:
# 单独添加一行或者列:add_row、add_column
row_cells = table.add_row().cells
for index, cell in enumerate(row_cells):
cell.text = str(data[index])
# 2.5 表格
head_datas = ["姓名", "年龄", "地区"]
datas = (
('张三', 18, '深圳'),
('李四', 28, '北京'),
('王五', 33, '上海'),
('孙六', 42, '广州')
)
# 新增一个表格,并指定样式
# add_table(doc, head_datas, datas, style_table)
add_table(doc, head_datas, datas)

需要指出的是,表格默认采用的样式是 Table Grid,也可以使用上面的方法自定义一个表格样式,插入表格的同时设置进去即可

4. 最后

本篇文章就 Word 写入数据的常规操作进行了一次全面梳理,更多功能包含:读取、修改、查找、删除等实战内容后面会持续输出

要获取全部源码,关注公众号「 AirPython 」,后台回复「 word 」即可获得全部源码

如果你觉得文章还不错,请大家 点赞、分享、留言下,因为这将是我持续输出更多优质文章的最强动力!

推荐阅读

最全总结 | 聊聊 Python 办公自动化之 Excel(上)

最全总结 | 聊聊 Python 办公自动化之 Excel(中)

最全总结 | 聊聊 Python 办公自动化之 Excel(下)

版权声明
本文为[AirPython]所创,转载请带上原文链接,感谢
https://www.cnblogs.com/xingag/p/13966035.html

  1. 利用Python爬虫获取招聘网站职位信息
  2. Using Python crawler to obtain job information of recruitment website
  3. Several highly rated Python libraries arrow, jsonpath, psutil and tenacity are recommended
  4. Python装饰器
  5. Python实现LDAP认证
  6. Python decorator
  7. Implementing LDAP authentication with Python
  8. Vscode configures Python development environment!
  9. In Python, how dare you say you can't log module? ️
  10. 我收藏的有关Python的电子书和资料
  11. python 中 lambda的一些tips
  12. python中字典的一些tips
  13. python 用生成器生成斐波那契数列
  14. python脚本转pyc踩了个坑。。。
  15. My collection of e-books and materials about Python
  16. Some tips of lambda in Python
  17. Some tips of dictionary in Python
  18. Using Python generator to generate Fibonacci sequence
  19. The conversion of Python script to PyC stepped on a pit...
  20. Python游戏开发,pygame模块,Python实现扫雷小游戏
  21. Python game development, pyGame module, python implementation of minesweeping games
  22. Python实用工具,email模块,Python实现邮件远程控制自己电脑
  23. Python utility, email module, python realizes mail remote control of its own computer
  24. 毫无头绪的自学Python,你可能连门槛都摸不到!【最佳学习路线】
  25. Python读取二进制文件代码方法解析
  26. Python字典的实现原理
  27. Without a clue, you may not even touch the threshold【 Best learning route]
  28. Parsing method of Python reading binary file code
  29. Implementation principle of Python dictionary
  30. You must know the function of pandas to parse JSON data - JSON_ normalize()
  31. Python实用案例,私人定制,Python自动化生成爱豆专属2021日历
  32. Python practical case, private customization, python automatic generation of Adu exclusive 2021 calendar
  33. 《Python实例》震惊了,用Python这么简单实现了聊天系统的脏话,广告检测
  34. "Python instance" was shocked and realized the dirty words and advertisement detection of the chat system in Python
  35. Convolutional neural network processing sequence for Python deep learning
  36. Python data structure and algorithm (1) -- enum type enum
  37. 超全大厂算法岗百问百答(推荐系统/机器学习/深度学习/C++/Spark/python)
  38. 【Python进阶】你真的明白NumPy中的ndarray吗?
  39. All questions and answers for algorithm posts of super large factories (recommended system / machine learning / deep learning / C + + / spark / Python)
  40. [advanced Python] do you really understand ndarray in numpy?
  41. 【Python进阶】Python进阶专栏栏主自述:不忘初心,砥砺前行
  42. [advanced Python] Python advanced column main readme: never forget the original intention and forge ahead
  43. python垃圾回收和缓存管理
  44. java调用Python程序
  45. java调用Python程序
  46. Python常用函数有哪些?Python基础入门课程
  47. Python garbage collection and cache management
  48. Java calling Python program
  49. Java calling Python program
  50. What functions are commonly used in Python? Introduction to Python Basics
  51. Python basic knowledge
  52. Anaconda5.2 安装 Python 库(MySQLdb)的方法
  53. Python实现对脑电数据情绪分析
  54. Anaconda 5.2 method of installing Python Library (mysqldb)
  55. Python implements emotion analysis of EEG data
  56. Master some advanced usage of Python in 30 seconds, which makes others envy it
  57. python爬取百度图片并对图片做一系列处理
  58. Python crawls Baidu pictures and does a series of processing on them
  59. python链接mysql数据库
  60. Python link MySQL database