之前介紹了一個Python包 openpyxl ，用于處理 Excel ；而對于 Word 文本時同樣也有對應(yīng)的 Python庫 Python-docx，在日常辦公中，如果需要處理多個 word 文本，且操作步驟都是重復(fù)單調(diào)的，我想這個庫就可以幫到你

在了解 Python-docx 常用函數(shù)之前，需要知道 在 Python-docx 各命令所對應(yīng) word 各部件，下圖所示，

• Document 指的是 word 文檔；
  
• paragraph 對應(yīng)段落；
  
• run 對應(yīng) 一句話中的各個字段，樣式調(diào)整時，一般面向的操作對象都是逐字段進行；
  

1，安裝 Python-docx

通過 pip 工具即可進行安裝，在命令行中輸入 pip install Python-docx 即可

2，創(chuàng)建或打開 Document

Python-docx 導(dǎo)入包時是以 docx 命令存在的，與 Opencv 的 Python 版本導(dǎo)入方法相似；創(chuàng)建文件、打開文件以 Document() 命令操作，這里操作時需要注意幾個點：

1，Document() 命令是基于默認”模板“創(chuàng)建一個空白文檔，隨后可對文檔進行編輯操作，最后沒有用 save() 函數(shù)存儲的話，文檔將伴隨程序結(jié)束同內(nèi)存一起

2，Document(path) 命令表示打開一個本地已經(jīng)存在的 docx 文件，path 表示存放目錄若不存在則程序報錯；
下面代碼中，創(chuàng)建了一個空白 docx，賦值給 document

from docx import Document

document = Document()

3，加入一段落

段落作為 docx 文檔正文的主要成分，那怎樣在創(chuàng)建好的 Document 中加入一段話呢？官方給出了兩種方式

1，在文檔后面插入

這種方法是比較常見且簡單的，命令如下

paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')

方法中將創(chuàng)建好的段落引用指向 paragraph ，表明了光標的位置，后面的一些操作可以借助 paragraph 引用變量來作為定位操作

2，在指定地方的前面插入

文檔編輯正常順序是在末尾進行編輯，但有時在編輯時可能失誤少輸入一段話或文字，這時就用到 在指定位置前面 進行插入操作

prior_paragraph = paragraph.insert_paragraph_before('Lorem ipsum')

此命令常用于 修正文檔 ，當(dāng)需要在一段話前面添加一些別的文字時。

4，標題

docx 中 會用一、二、三級標題將正文分為幾部分，讓文本主次感更強；Python-docx 有對應(yīng)的內(nèi)置函數(shù)供我們使用，內(nèi)置函數(shù)中標題分為主標題和子標題

創(chuàng)建標題的函數(shù)方法中，有一個參數(shù) level 可進行修改，若不設(shè)定時默認為 主標題（leve = 0）；

document.add_heading('The REAL meaning of the universe')

子標題分為 1-9 九個等級，修改參數(shù) level 即可

document.add_heading('The role of dolphins', level=2)

5，分頁符

在 Word 中進行文本編輯，想在單獨的一個新頁面編寫文本時，就需要加入一個 強制分頁符，命令如下

document.add_page_break()

這里需要注意下，加入分頁符之后，新頁面上編輯的段落樣式屬性與之前頁面段落屬性是分隔開的

6，表格

在文檔中創(chuàng)建一個 2*2 的 表格

table = document.add_table(rows=2, cols=2)

表格中每個單元格可進行文本編輯，顏色填充；對于特定表格而言可通過 row、column 索引來進行定位，這里借助了操作 Excel 表格的思想

cell = table.cell(0, 1)

賦值其文本內(nèi)容

cell.text = 'parrot, possibly dead'

對一個一個單元格修改操作太麻煩了，可以一次選中指定列，對其單元格數(shù)據(jù)進行逐個修改

row = table.rows[1]
row.cells[0].text = 'Foo bar to you.'
row.cells[1].text = 'And a hearty foo bar to you too sir!'

table.rows[index] 返回索引為 index 的指定行，根據(jù) .rows和.cols 表示 表格的全部行或列是可迭代的，因此可通過 for 循環(huán)來訪問每一個單元格

for row in table.rows:
for cell in row.cells:
print(cell.text)

因為 .rows 和 .cols 是可迭代的，通過 len() 命令來獲取行、列數(shù)

row_count = len(table.rows)
col_count = len(table.columns)

除了以上操作之外，還可以向 table 中逐漸添加行、列命令

row = table.add_row()
col = table.add_col()

上面提到了 創(chuàng)建表格，單元格修改，創(chuàng)建新行/列，逐行/列迭代，下面用個實例做個簡單總結(jié)，代碼中完成功能如下：

• 1，item 創(chuàng)建一個 3*3 的元組數(shù)據(jù)；
• 2，在 word 中新建一個 table，一行三列；
• 3，創(chuàng)建好的 table 的表頭依次設(shè)置為 Qty，SKU，Description；
• 4，將 item 中的元素，以 table 逐行 3 個的方式創(chuàng)建；

# get table data -------------
items = (
  (7, '1024', 'Plush kittens'),
  (3, '2042', 'Furbees'),
  (1, '1288', 'French Poodle Collars, Deluxe'),
)

# add table ------------------
table = document.add_table(1, 3)

# populate header row --------
heading_cells = table.rows[0].cells
heading_cells[0].text = 'Qty'
heading_cells[1].text = 'SKU'
heading_cells[2].text = 'Description'

# add a data row for each item
for item in items:
  cells = table.add_row().cells
  cells[0].text = str(item.qty)
  cells[1].text = item.sku
  cells[2].text = item.desc

此外，還可修改 表格的樣式，word 文檔中的表格樣式這里都可以設(shè)定(樣式名稱可以通過word 文檔自有的樣式，將鼠標放到樣式的縮略圖上即可查看)，但需要注意的是，使用樣式時需要去掉word軟件中樣式名字中的空格，例如下面 Office 原樣式名字為 Light Shading-Accent1，這里直接把中間空格去掉

table.style = 'LightShading-Accent1'


7，圖片

在 python-docx 中添加圖片用下面命令即可完成

document.add_picture('image-filename.png')

上面加入的是本地文件 path ，除此之外還可以使用 file-like object，這種格式對于數(shù)據(jù)庫或者網(wǎng)絡(luò)上的圖片讀取時時非常方便的

修改圖片大小

python-docx 加入圖像默認表示的是 native size，正常圖片加入時會出現(xiàn)相同圖片的一側(cè)出現(xiàn) 4.167 inches 的空白處，大概占比紙張寬度的一半；在獲取想要圖像大小時，可以指定寬度或高度設(shè)為較為方便的單位

from docx.shared import Inches

document.add_picture('image-filename.png', width=Inches(1.0))

8, 應(yīng)用段落樣式

設(shè)定段落樣式方法有兩種，一種創(chuàng)建時就可以設(shè)置

document.add_paragraph('Lorem ipsum dolor sit amet.', style='ListBullet')

另一種是創(chuàng)建完之后再再進行設(shè)置(這時不需要去掉樣式名稱中的空格)

paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')
paragraph.style = 'List Bullet'

9，字體加黑并斜體化

對字體做斜體和加黑操作之前， 需要理解在一個段落中都做了什么事情，簡單來說兩部分：

1，一個段落具有全部 block-level formatting ，比如制表符、行高、tabs 等；

2，Character-level formatting ，例如粗體、斜體，應(yīng)用的是 run對象，在段落中的所有內(nèi)容必須是一個 run ，且不僅包含一個，
Run 對象同時包含一個 .bold 和.italic 屬性，可讓你來對其值進行設(shè)置

paragraph = document.add_paragraph('Lorem ipsum ')
run = paragraph.add_run('dolor')
run.bold = True
paragraph.add_run(' sit amet.')

上面代碼中最后創(chuàng)建的文本格式形如：Lorem ipsum dolor sit amet.

需要注意的是設(shè)置 bold 或 italic 時，可以把 .add_run() 命令直接放在右邊

paragraph.add_run('dolor').bold = True

# is equivalent to:

run = paragraph.add_run('dolor')
run.bold = True

# except you don't have a reference to `run` afterward

10，字符樣式

除了上面加黑、斜體之外、還可定義字符樣式( character styles )， 定義時加入一行新的 run 對象；例如

paragraph = document.add_paragraph('Normal text, ')
paragraph.add_run('text with emphasis.', 'Emphasis')

上面創(chuàng)建一個文本 ，結(jié)果如下

Normal text,text with emphasis. ；text with emphasis. 部分應(yīng)用 Emphasis(強調(diào)) 的字符格式

上面代碼也可改為；

paragraph = document.add_paragraph('Normal text, ')
run = paragraph.add_run('text with emphasis.')
run.style = 'Emphasis'

與段落樣式一樣，樣式名字與 Word UI 里的一樣，在 Word 樣式管理器中都能找得到！

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評論