本篇文章讨论如何设置样式,以及如何利用Word的样式管理器。
=========================================================================================================================================================================================================
通常,在排版管理中,与字符内容无关的所有可视要素都可称之为『样式』,具体说来,包括字体、颜色、对齐、行间距等等。
在Word(以及带有文本编辑功能的Office软件)中,从样式应用的对象分,常用的样式类型有字符样式、段落样式、表格样式、枚举样式等。python-docx目前主要支持前三类,已经基本满足日常使用。
每种样式包含的内容主要有字体(包括字体名称、颜色、倾斜、加粗)和段落格式(缩进、分页模式)等。根据样式应用对象的不同,每类样式不一定包含所有的内容。例如,字符样式就没有段落格式这个内容。
Word有样式管理器,负责管理内建样式和用户自定义样式。python-docx可以操作这个管理器,把自定义的样式添加到管理器里,或者从管理器选取一个样式加以应用。
由于python-docx的样式设置并不能包含Word的所有样式设置。因此个人的建议是:当你的操作只是涉及Word本身(例如批量整理文件格式),可以利用Word的图形界面设置好自定义样式,然后利用python-docx操作样式管理器,给特定的对象特定的样式。
当你的操作涉及Word之外的东西,而且对样式设置的要求不高(例如,HTML转Word,或者格式比较简单的文档,例如公文),可以使用python-docx直接设置样式。
如果你既不能用Word设置自定义样式(例如需要几百种样式类型),又对样式类型的设置要求很高,则不要用python-docx,考虑VBScript/VBA,或者win32com等功能完备的工具。
1. 创建样式和设置字体
游程对象、段落对象和表格对象都有一个成员Style,而这个Style有一个成员Font,包含了字体的所有设置。
如果凭空的创建一个Style,要使用Document对象的Styles集合的add_style方法。下面的例子里添加了10个段落,为每个段落创建一个新的Style。这些Style的区别是字号依次增加。
# -*- coding: utf-8 -*-
from docx import Document
from docx.shared import Pt
from docx.enum.style import WD_STYLE_TYPE
doc = Document()
for i in range(10):
p = doc.add_paragraph(u'段落%d' % i)
style = doc.styles.add_style('UserStyle%d' %i,WD_STYLE_TYPE.PARAGRAPH)
style.font.size = Pt(i+20)
p.style = style
doc.save('4-1.docx')
注意到python-docx提供了docx.shared模块,供以Pt(磅)为单位设置字体。类似的单位有Mm、Cm、Inches、Emu(物理尺寸)以及Twips(缇,微软喜好的一种蜜汁尺寸)
对于游程对象,其字体操作可以直接使用Run.font成员。下面给一个字体变化的一句话:
# -*- coding: utf-8 -*-
from docx import Document
from docx.shared import RGBColor
from docx.oxml.ns import qn
doc = Document()
p = doc.add_paragraph()
text_str = u'一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。'
for i,ch in enumerate(text_str):
run = p.add_run(ch)
font = run.font
font.name = u'微软雅黑'
# bug of python-docx
run._element.rPr.rFonts.set(qn('w:eastAsia'), u'微软雅黑')
font.bold = (i % 2 == 0)
font.italic = (i % 3 == 0)
color = font.color
color.rgb = RGBColor(i*10 % 200 + 55,i*20 % 200 + 55,i*30 % 200 + 55)
doc.save('4-2.docx')
这里使用了docx.shared模块提供的RGBColor类。
2. 段落格式
对于段落样式和表格样式,有一个段落格式的成员paragraph_format。它相当于Word的这个选项:
相应的,段落格式对象的各种成员,相当于对话框里的这些设置要素:ParagraphFormat.alignment (选择一个WD_PARAGRAPH_ALIGNMENT)
ParagraphFormat.left_indent(长度)
ParagraphFormat.right_indent(长度)
ParagraphFormat.first_line_indent(长度)
ParagraphFormat.space_before(长度)
ParagraphFormat.space_after(长度)
ParagraphFormat.line_spacing_rule(选择一个WD_LINE_SPACING)
ParagraphFormat.line_spacing(长度)
ParagraphFormat.widow_control(True:设置,None:继承Style设置)
ParagraphFormat.keep_with_next(True:设置,None:继承Style设置)
ParagraphFormat.keep_together(True:设置,None:继承Style设置)
ParagraphFormat.page_break_before(True:设置,None:继承Style设置)
比如可以这样设置递进的左对齐:
# -*- coding: utf-8 -*-
from docx import Document
from docx.shared import Cm
from docx.enum.style import WD_STYLE_TYPE
doc = Document()
for i in range(10):
p = doc.add_paragraph(u'段落%d' % i)
style = doc.styles.add_style('UserStyle%d' %i,WD_STYLE_TYPE.PARAGRAPH)
style.paragraph_format.left_indent = Cm(i)
p.style = style
doc.save('4-3.docx')3. 样式管理器
Word自带很多样式。可以利用Document.styles集合来进行访问builtin属性为True的自带样式。当然,你自己通过add_style增加的样式,也会放在styles集合里。
对于你自己创建的样式,若将其hidden和quick_style属性分别设置为False和True,则可将这个自创建样式添加到Word的快速样式管理器里。
下面举一个综合的例子。
# -*- coding: utf-8 -*-
from docx import Document
from docx.shared import Cm
from docx.enum.style import WD_STYLE_TYPE
doc = Document()
for i in range(10):
p = doc.add_paragraph(u'段落%d' % i)
style = doc.styles.add_style('UserStyle%d' %i,WD_STYLE_TYPE.PARAGRAPH)
style.paragraph_format.left_indent = Cm(i)
p.style = style
if i == 7:
style.hidden = False
style.quick_style = True
for style in doc.styles:
print style.name,style.builtin
doc.paragraphs[3].style = doc.styles['Subtitle']
doc.save('4-4.docx')
注意样式面板的第二个快速样式就是我们刚刚添加的『UserStyle7』
=======================
到此,这一系列的Word部分就告一段落了。接下来,本系列文章将聊一聊用python操作PowerPoint。
参考: