docx库的下载指令：
pip install python-docx
1、文档
创建文档
from docx import Document
document = Document()
保存文档
document.save('test.docx')
打开现有文档
document = Document('filename.docx') # 打开
document.save('new-filename.docx') #保存文档
如果使用相同的文件名来打开和保存文件，将默认覆盖原文件
打开file-like文档
f = open('a.docx', 'rb')
document = Document(f)
f.close()
or
with open('a.docx', 'rb') as f:
source_stream = StringIO(f.read())
document = Document(source_stream)
source_stream.close()
target_stream = StringIO()
document.save(target_stream)
2、段落
添加段落
paragraph = document.add_paragraph("This is the first paragraph")
作用：在文档末尾添加一个新的段落，并返回该段落的引用。
prior_paragraph = paragraph.insert_paragraph_before("such a good boy")
作用：以某个段落为基准，在这个段落前添加一个新的段落。
添加段落风格
paragraph.style = "List Bullet"
这种风格使得段落看起来像子弹头。
在段落中添加内容
run = paragraph.add_run("it is wonderful")
run = paragraph.add_run("it is wonderful", "Emphasis") # 创建时指定风格
这还将返回一个对字符串”it is wonderful”的引用，我们可以对这个字符串进行格式的设置。
run.bold = True # 设置为粗体
run.italic = True # 设置为斜体
run.style = "Emphasis" # 创建后设置风格
设置段落格式
段落的对齐方式
from docx.enum.text import WD_ALIGN_PARAGRAPH
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER # 设置为居中对齐
段落的缩进
paragraph.paragraph_format.left_indent = Inches(0.5) # 向左缩进
paragraph.paragraph_format.right_indent = Inches(0.5) # 向右缩进
paragraph.paragraph_format.first_line_indent = Inches(0.5) #第一行缩进
段落间隔
from docx.shared import Pt
paragraph.paragraph_format.space_before = Pt(18)
paragraph.paragraph_format.space_after = Pt(12)
行间距
paragraph.paragraph_format.line_spacing = Pt(18)
分页属性：
keep_together：使整个段落出现在同一页上，如果该段落可能被分割成两页，则在该段之前加入分页符。
keep_with_next：保持与下一段保持一个段落在相同的页面。
page_break_before：使用分页符将段落放置在新页的顶部。
widow_control：避免将该段的第一行或最后一行放在与该段其余部分分开的页面上。
paragraph.paragraph_format.keep_together = True
paragraph.paragraph_format.keep_with_next = False
3、标题
添加标题
document.add_heading('My first doc created by python')
作用：添加一个顶级标题。
标题共有9级，可通过level属性来指定级数，如：
document.add_heading('My first doc created by python', level=3)
会创建一个3级标题。
若指定级别为0，则将创建一个段落
4、分页符
document.add_page_break()
作用：无论所在页面是否已满，都将转到一个新的页面上
5、表格
添加表格
table = document.add_table(rows=2, cols=2)
作用：创建一个2行，2列的表格(可视作一个二维数组)
获取引用
cell = table.cell(0,1) # 获取第一行第二列的元素的引用
row = table.rows[1] # 获取第二行的引用
cell = row.cells[1] # 获取第二行(即上一行代码所获得的行)的第二个元素
方法
cell.text = 'hello, good morning' # 修改单元格的文本
row_count = len(table.rows) # 统计表格行数
row = table.add_row() # 添加新的一行
table.style = 'LightShading-Acccent1' # 表格样式
6、图片
添加图片
document.add_picture('snow.jpg')
添加了一张文件名为”snow.jpg”的图片
控制图片大小
form docx.shared import Inches
document.add_picture('snow.jpg', width=Inches(1))
7、字体设置
from docx.shared import Pt
from docx.shared import RGBColor
from docx.enum.dml import MSO_THEME_COLOR
run = document.add_paragraph().add_run()
font = run.font
font.name = 'Calibri' #字体种类
font.size = Pt(12) #字体大小
font.bold = True # 粗体
font.italic = False # 斜体
font.underline = True # 下划线
font.color.rgb = RGBColor(0x42, 0x24, 0xE9) # 字体颜色
font.clor.theme_color = MSO_THEME_COLOR.ACCENT_1 # 设置配色
font.color.rgb = None # 默认颜色
8、section属性
section的使用
sections = document.sections
section = sections[0]
section的属性
-
start_type：这个部分之前的断开类型
-
orientation：页面方向
-
page_width：页面宽度
-
page_height：页面高度
-
left_margin：左边距
-
right_margin：右边距
-
top_margin：上边距
-
bottom_margin：下边距
-
gutter
-
header_distance
-
footer_distance
section.start_type = WD_SECTION.ODD_PAGE
section.orientation = WD_ORIENT.LANDSCAPE
section.page_width = new_width
section.page_height = new_height
section.left_margin = Inches(1.5)
section.right_margin = Inches(1)
9、页眉和页脚
获取
section = document.sections[0]
header = section.header
使用
paragraph = header.paragraphs[0]
paragraph.text = "Title of my document" # 在页眉添加内容
paragraph.text = "Left Text\tCenter Text\tRight Text" #制表符用于分隔左、中和右对齐的标题内容
paragraph.style = document.styles['header']
删除
header.is_linked_to_previous = True