python-docx处理word文档功能详细说明
安装模块
- 由于
python-docx
已经提交给 PyPI 仓库,所以可以使用pip
安装,如下:pip install python-docx
如果同时安装了
python2
和python3
那么pip
可能不能用,可以使用pip3
来安装,如下:pip3 install python-docx
python-docx
也可以使用easy_install
来安装,如下:easy_install python-docx
- 如果不能使用
pip
和easy_install
,可以在PyPI
下载包、解压、运行setup.py
,如下:tar xvzf python-docx-{version}.tar.gz cd python-docx-{version} python setup.py install
python-docx
还依赖lxml
包 ,使用前2种方法会自动安装所需依赖包,第三种方法需要自己手动安装。
处理word文档
新建文档类
首先新建一个空白文档类 Document ,如下:
from docx import Documentdocument = Document()
编辑已存在的word文档
python-docx 不仅可以创建word文档,还可以编辑已存在的word文档。
其实吧,这玩意儿只能编辑已存在的word文档,之所以有个“创建空白文档”的功能,只不过是拷贝一份空白word文档到工作区间,再在空白文档上编辑,看起来似乎是“创建空白文档”罢了。本质上还是编辑已存在的word文档,捂脸中…
打开一个word文档,编辑完后,一定要记得保存。如果保存文件名和原文件名不一样,则会另存为一份word文档;若文件名一样,则会不加提示的保存修改内容。如下:
from docx import Documentdocument = Document('existing-document-file.docx')
document.save('new-file-name.docx')
新增段落
在word中 段落
是最常见的,创建段落 paragraph 的操作如下:
paragraph = document.add_paragraph('这是个段落。')
在此段落之前插入一个段落,如下:
prior_paragraph = paragraph.insert_paragraph_before('这是前面的段落。')
新增标题
新增标题代码如下:
document.add_heading('这是个标题')
修改标题大小,有1-9种规格,如下:
document.add_heading('The role of dolphins', level=2)
如果使用 level=0
,则会新增一个带有下划线样式的标题。
新增分页符
代码如下:
document.add_page_break()
新增表格
创建一个2行2列的表格 Table,如下:
table = document.add_table(rows=2, cols=2)
获取第一行第二列的单元格类,如下:
cell = table.cell(0, 1)
写入数据,如下:
cell.text = '这是第一行第二列的单元格'
不仅如此,还能以数组的形式获取整个行或列,如下:
row = table.rows[1]
row.cells[0].text = '第二行第一列'
row.cells[1].text = '第二行第二列'
或循环操作,如下:
for row in table.rows:for cell in row.cells:print(cell.text)
用 len()
方法获取行数或列数,如下:
row_count = len(table.rows)
col_count = len(table.columns)
增加行,如下:
row = table.add_row()
设置表格样式,如下:
table.style = 'LightShading-Accent1'
插入图片
插入本地图片,如下:
document.add_picture('demo.png')
默认情况下,图片大小往往不尽如人意,调整图片大小,如下:
from docx.shared import Inchesdocument.add_picture('demo.png', width=Inches(1.0), height=Inches(1.0))
若同时定义宽度和高度,则图片会被拉伸或压缩到指定大小;若仅定义宽度或高度,则图会自适应调整大小。所以,建议仅定义宽度即可。
段落操作
设置段落样式
如下:
document.add_paragraph('这是一个样式为 ListBullet 的段落', style='ListBullet')
或
paragraph = document.add_paragraph('这是一个样式为 ListBullet 的段落')
paragraph.style = 'List Bullet'
设置段落对齐方式
段落对齐方式有 左对齐
、 文字居中
、 右对齐
、 文本两端对齐
等,更多对齐方式请移步 WD_ALIGN_PARAGRAPH
from docx.enum.text import WD_ALIGN_PARAGRAPH# LEFT => 左对齐
# CENTER => 文字居中
# RIGHT => 右对齐
# JUSTIFY => 文本两端对齐paragraph = document.add_paragraph("你说啥")
paragraph_format = paragraph.paragraph_format
paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER
设置段落缩进
设置段落缩进,可为负值,如下:
from docx.shared import Inchesparagraph = document.add_paragraph("你说啥")
paragraph_format = paragraph.paragraph_format
paragraph_format.left_indent = Inches(0.5)
也可以设置首行缩进,如下:
paragraph_format.first_line_indent = Inches(-0.25)
设置段落制表符
详情请移步 TabStops
设置段落间距
分为 段前
和 段后
,设置值用 Pt
单位是 磅
,如下:
paragraph_format.space_before = Pt(18)
paragraph_format.space_after = Pt(12)
设置段落行距
当行距为 最小值
和 固定值
时,设置值单位为 磅
,需要用 Pt
;当行距为 多倍行距
时,设置值为数值,如下:
from docx.shared import Length#SINGLE => 单倍行距(默认)
#ONE_POINT_FIVE => 1.5倍行距
#DOUBLE2 => 倍行距
#AT_LEAST => 最小值
#EXACTLY => 固定值
#MULTIPLE => 多倍行距paragraph.line_spacing_rule = WD_LINE_SPACING.EXACTLY #固定值
paragraph_format.line_spacing = Pt(18) # 固定值18磅
paragraph.line_spacing_rule = WD_LINE_SPACING.MULTIPLE #多倍行距
paragraph_format.line_spacing = 1.75 # 1.75倍行间距
设置段落分页
- 孤行控制
防止在页面顶端单独打印段落末行或在页面底端单独打印段落首行。 - 与下段同页
防止在选中段落与后面一段间插入分页符。 - 段中不分页
防止在段落中出现分页符。 - 段前分页
在选中段落前插入分页符。#widow_control => 孤行控制 #keep_with_next => 与下段同页 #page_break_before => 段前分页 #keep_together => 段中不分页paragraph_format.keep_with_next = True
字体操作
设置粗体和斜体
在设置粗体和斜体之前,我们先简单了解一下
段落
里的运行机制。段落包含很多块级的格式,比如缩进、行高、制表符等。每一个小片段叫做一个 run ,可以对run
设置粗体和斜体等属性。
我们可以设置如下:paragraph = document.add_paragraph() paragraph.add_run('这是一个带有') paragraph.add_run('粗体').bold = True paragraph.add_run('和') paragraph.add_run('斜体').italic = True paragraph.add_run('的段落。')
设置字体属性
对
run
设置字体、大小、颜色下划线等,更多属性请移步 Font ,如下:from docx.shared import RGBColor,Pt#all_caps => 全部大写字母 #bold => 加粗 #color => 字体颜色 #complex_script => 是否为“复杂代码” #cs_bold => “复杂代码”加粗 #cs_italic => “复杂代码”斜体 #double_strike => 双删除线 #emboss => 文本以凸出页面的方式出现 #hidden => 隐藏 #imprint => 印记 #italic => 斜体 #name => 字体 #no_proof => 不验证语法错误 #outline => 显示字符的轮廓 #shadow => 阴影 #small_caps => 小型大写字母 #snap_to_grid => 定义文档网格时对齐网络 #strike => 删除线 #subscript => 下标 #superscript => 上标 #underline => 下划线paragraph = document.add_paragraph() paragraph.add_run('这是一个带有') paragraph.add_run('颜色').font.color.rgb = RGBColor(54, 95, 145) paragraph.add_run('的') paragraph.add_run('大字').font.size = Pt(36) # 字体大小设置,和word里面的字号相对应
设置字符样式
除了设置段落样式外,还可以设置一组字符样式,比如字体、大小、颜色、粗体、斜体等,如下:
# 自定义样式 Emphasisparagraph = document.add_paragraph('这是一个带有') paragraph.add_run('自定义样式', 'Emphasis') paragraph.add_run('的段落')
或
paragraph = document.add_paragraph('这是一个带有 ') run = paragraph.add_run('自定义样式') run.style = 'Emphasis' paragraph.add_run('的段落')
页眉和页脚
更多内容请移步 Working with Headers and Footers
枚举的文档
- MSO_COLOR_TYPE
- MSO_THEME_COLOR_INDEX
- WD_PARAGRAPH_ALIGNMENT
- WD_BUILTIN_STYLE
- WD_CELL_VERTICAL_ALIGNMENT
- WD_COLOR_INDEX
- WD_LINE_SPACING
- WD_ORIENTATION
- WD_TABLE_ALIGNMENT
- WD_ROW_HEIGHT_RULE
- WD_SECTION_START
- WD_STYLE_TYPE
- WD_TAB_ALIGNMENT
- WD_TAB_LEADER
- WD_TABLE_DIRECTION
- WD_UNDERLINE
名称解释
官网解释
python-docx处理word文档功能详细说明相关推荐
- python docx修改word文档格式
修改word文档格式,包括修改目录字体字号间距,修改一级标题字体字号间距,二级标题字体字号间距....正文字体字号间距,表格中的文字的字体字号间距,以图或表开头的图名称和表名称的字体字号间距. wor ...
- python 合并word文件_使用python docx合并word文档
合并包含所有样式的两个文档的另一种方法是使用python库docxcompose(https://pypi.org/project/docxcompose/).我们不需要明确定义样式,也不必逐段阅读文 ...
- python docx处理word文档中表格合并问题
问题描述 python中用docx库读取word文件,若word文件中包含合并的表格表格 则通过docx读取显示: file = docx.Document(path) for table in fi ...
- python生成word文档_python实现的生成word文档功能示例
本文实例讲述了python实现的生成word文档功能.分享给大家供大家参考,具体如下: 每月1次的测试费用报销,需要做一个文档.干脆花点时间写个程序吧. # -*- coding: utf-8 -*- ...
- python 自动生成word文档,python实现的生成word文档功能示例
python实现的生成word文档功能示例 发布时间:2020-09-23 11:37:44 来源:脚本之家 阅读:108 作者:zhizunyu2009 本文实例讲述了python实现的生成word ...
- 【Python】导出docx格式Word文档中的文本、图片和附件等
[Python]导出docx格式Word文档中的文本.图片和附件等 零.需求 为批量批改学生在机房提交的实验报告,我需要对所有的实验文档内容进行处理.需要批量提取Word文档中的图片和附件以便进一步检 ...
- python 自动生成word文档_python实现的生成word文档功能示例
本文实例讲述了python实现的生成word文档功能.分享给大家供大家参考,具体如下: 每月1次的测试费用报销,需要做一个文档.干脆花点时间写个程序吧. # -*- coding: utf-8 -*- ...
- Python批量提取docx格式Word文档中所有批注
封面图片:<Python程序设计基础与应用>(ISBN:9787111606178),董付国,机械工业出版社 图书详情: 用书教师可以联系董老师获取教学大纲.课件.源码.教案.考试系统等配 ...
- python-docx中文开发文档_使用Python语言-docx生成Word文档
本文主要向大家介绍了使用Python语言-docx生成Word文档,通过具体的内容向大家展示,希望对大家学习Python语言有所帮助. < 学会来使用python操作数据表和PDF,今天我们尝试 ...
- python批量提取word指定内容_使用python批量读取word文档并整理关键信息到excel表格的实例...
目标 最近实验室里成立了一个计算机兴趣小组 倡议大家多把自己解决问题的经验记录并分享 就像在CSDN写博客一样 虽然刚刚起步 但考虑到后面此类经验记录的资料会越来越多 所以一开始就要做好模板设计(如下 ...
最新文章
- Scala 集合入门
- uniapp同步获取用户信息_微信小程序云开发教程微信小程序的API入门获取用户身份信息系列API...
- java setmethod_Java Operation.setJavaMethod方法代码示例
- TCP/IP之传输层(一)
- 6月8号=》105页-110页
- Java设计模式-工厂模式(1)简单工厂模式
- quantum theory
- 前端学习(1671):前端系列实战课程之透明度运动效果实现思路
- java怎么发布版本号_java 实现比较版本号功能
- maven 配置环境变量
- C++设计模式——模板方法(Template Method)
- php 采集网站关键字,php远程获取网站的关键字信息(并附:php判断字符串编码)...
- 计算机视觉教程6-1:图解双目视觉系统与立体校正原理
- 1 分析计算机上网时断时续的原因,网络丢包现象分析与解决方案
- 程序员的核心竞争力是怎样的?列举程序员要掌握的能力
- 简单的集装箱号码识别
- linux下hg命令
- bash中的字符串长度
- 怎样卸载teams_如何在Windows 10上永久卸载Microsoft Teams
- 适合 Ubuntu的8款最佳录屏软件