python-docx 頁面設定

站著活 發表於 2021-10-10
Python

初識word文件-節-的概念

編輯一篇word文件,往往首先從頁面設定開始,從下圖可以看出,頁面設定常操作的有頁邊距、紙張方向、紙張大小4個,而在word中是以節(section)來分大的塊,每一節的頁面設定可以不同。所以在python-docx中也是一樣,當前節的各項屬性全部儲存在當前的section中,要想設定當前節的頁面就從瞭解section的各個屬性應用開始吧。

python-docx 頁面設定

 

如果用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’就改成幾。