python-docx 页面设置详解
目录
- 初识word文档-节-的概念
- 设置页边距
- 设置纸张方向和大小
- 设置分栏
- 总结
初识word文档-节-的概念
编辑一篇word文档,往往首先从页面设置开始,从下图可以看出,页面设置常操作的有页边距、纸张方向、纸张大小4个,而在word中是以节(section)来分大的块,每一节的页面设置可以不同。所以在python-docx中也是一样,当前节的各项属性全部保存在当前的section中,要想设置当前节的页面就从了解section的各个属性应用开始吧。
如果用python-docx新建一个空白文档,那么默认是只有一个节
>>> import docx >>> doc = docx.Document() >>> len(doc.sections) 1
,如果要增加节可以用doc.add_section()来完成。
>>> import docx >>> doc = docx.Document() >>> len(doc.sections) 1 >>> doc.add_section() <docx.section.Section object at 0x000001F27F85E370> >>> len(doc.sections) 2
了解了节之后我们开始来对节的页面进行设置。
设置页边距
在python-docx包中常用页边距属性存在section的以下4个属性中:
section.top_margin
:上页边距
section.bottom_margin
:下页边距
section.left_margin
:左页边距
section.right_margin
:右页边距
页边距的值以厘米(cm)为单位,让我们来看看刚才第二节的默认的页边距是多少
>>> print('上',doc.sections[1].top_margin.cm,'下',doc.sections[1].bottom_margin.cm,'左',doc.sections[1].left_margin.cm,'右',doc.sections[1].right_margin.cm) 上 2.54 下 2.54 左 3.175 右 3.175
注,这里的sections[1]是第二节。
下面把页边距设置成我们公文常用的5678页面距
>>> from docx.shared import Cm >>> doc.sections[1].top_margin = Cm(3.7) >>> doc.sections[1].bottom_margin = Cm(3.5) >>> doc.sections[1].left_margin = Cm(2.8) >>> doc.sections[1].right_margin = Cm(2.6)
这里要先导入docx中定义单位的Cm,后面常用的单位还有Pt 也是这个块导入。
另外 页边距属性还有3个不常用的就是装订线,页眉、页脚边距分别为:section.gutter,section.header_distance, section.footer_distance
,设置方法同上,不再赘述。需要说明的是装订线还有一个位置属性,暂时未发现如何设置,默认为左,如果需求设置成右,可以建个模板docx文档导入。
设置纸张方向和大小
Section中的三个属性描述了页面方向和尺寸。分别为:section.orientation, section.page_width, section.page_height
纸张大小设置单位我习惯用cm,设置同页边距。
这里要特别说下orientation,即纸张方向,也是要设置的,不能说你把纸张宽度设置宽了,高度设置低了纸张就变成横向了,会影响打印等。
纸张方向的值是docx.enum.section.WD_ORIENTATION中枚举类型的2常量来设置的。分别为:
WD_ORIENTATION.LANDSCAPE
:纸张方向为横向。
WD_ORIENTATION.PORTRAIT
:纸张方向为纵向。
先查看下:
>>> doc.sections[0].page_height.cm 27.94 >>> doc.sections[0].page_width.cm 21.59 >>> doc.sections[0].orientation 0
默认的是信纸大小,横向
设置成我们常用的A4纸大小下:
from docx.shared import Cm from docx.enum.section import WD_ORIENTATION doc.sections[0].page_height = Cm(29.7) # 设置A4纸的高度 doc.sections[0].page_width = Cm(21) # 设置A4纸的宽 doc.sections[0].orientation = WD_ORIENTATION.PORTRAIT # 设置纸张方向为横向,可以不设置 默认为横向 doc.sections[1].page_height = Cm(21) # 设置A4纸的高度 doc.sections[1].page_width = Cm(29.7) # 设置A4纸的宽 doc.sections[1].orientation = WD_ORIENTATION.LANDSCAPE # 设置纸张方向为纵向
设置分栏
有些时候我们还要在某些节中分栏,给节设置分栏的语句比较固定,就是更改section的一个私有属性。先导入docx.oxml.ns.qn,然后一句话搞定
from docx.oxml.ns import qn doc.sections[1]._sectPr.xpath('./w:cols')[0].set(qn('w:num'), '2') #把第二节设置为2栏
想设置成几栏 把‘2'就改成几。
总结
本篇文章就到这里了,希望能够给你带来帮助,也希望您能够多多关注我们的更多内容!