在2017年暑假綠盟實習期間，部門做的一個專案需要用到docx格式的word文件模板操作，現在有如下記錄：

     關於python操作docx格式文件，我用到了兩個python包，一個便是python-docx包，另一個便是python-docx-template;,同時我也用到了很出名的一個工具"pandoc，下面我會對他們各自進行介紹。

1.     首先便是python-docx包，這是一個很強大的包，可以用來建立docx文件，包含段落、分頁符、表格、圖片、標題、樣式等幾乎所有的word文件中能常用的功能都包含了，這個包的主要功能便是用來建立文件，相對來說用來修改功能不是很強大，關於文件請檢視他的"
   官網;
   
   
2. 再然後便是python-docx-template這個包了，他可以用來對docx文件進行修改，諸如對文件中的 文字、圖片、富文字、等幾乎所有存在與文件中的他都能替換，而且他操作起來就如同很多web框架中的模板語言一樣，因為他是和jinjia2模板語言結合使用的，所以最好希望使用之前對模板語言有一定了解；
   
   
3. 關於pandoc，這個包在許多需要進行文字轉換的地方用處很強大，他可以把許多如今存在的文件格式轉換問另一種文件格式，如html、markdown、docbook、latex、docx等轉換為xml、latex、markdown、pdf，總之很強大，這是官網,有興趣的可以去了解下。

下面便會相應介紹他們各自的大概的用法。還是按照上面的順序進行介紹，

• 關於python-docx這個包我覺得最好還是引用他官網的一段程式碼解釋最為合適了，因為這裡面基本情況都被包含了，

1. from docx import Document<span id="transmark" style="display: none; width: 0px; height: 0px;"></span>  
2. from docx.shared import Inches  
3. document = Document()  # 首先這是包的主要介面，這應該是利用的設計模式的一種，用來建立docx文件，裡面也可以包含文件路徑(d:\\2.docx)
4. document.add_heading('Document Title'
   , 0)  # 這裡是給文件新增一個標題，0表示 樣式為title，1則為忽略，其他則是Heading{level},具體可以去<a target="_blank" href="https://python-docx.readthedocs.io/en/latest/user/styles-understanding.html">官網</a>查;
5. p = document.add_paragraph('A plain paragraph having some ') # 這裡是新增一個段落
6. p.add_run('bold').bold = True# 這裡是在這個段落p裡文字some後面新增bold字元
7. p.add_run(' and some ')  
8. p.add_run('italic.').italic = True
9. document.add_heading('Heading, level 1', level=1)   # 這裡是新增標題1
10. document.add_paragraph('Intense quote', style='IntenseQuote') # 這裡是新增段落，style後面則是樣式
11. document.add_paragraph(  
12.     'first item in unordered list', style='ListBullet'# 新增段落，樣式為unordered list型別
13. )  
14. document.add_paragraph(  
15.     'first item in ordered list', style='ListNumber'# 新增段落，樣式為ordered list數字型別
16. )  
17. document.add_picture('monty-truth.png', width=Inches(1.25))  # 新增圖片
18. table = document.add_table(rows=1, cols=3)   # 新增一個表格，每行三列
19. hdr_cells = table.rows[0].cells   # 表格第一行的所含有的所有列數
20. hdr_cells[0].text = 'Qty'# 第一行的第一列,給這行裡面新增文字
21. hdr_cells[1].text = 'Id'
22. hdr_cells[2].text = 'Desc'
23. for item in recordset:  
24.     row_cells = table.add_row().cells   # 這是在這個表格第一行 (稱作最後一行更好) 下面再新增新的一行
25.     row_cells[0].text = str(item.qty)  
26.     row_cells[1].text = str(item.id)  
27.     row_cells[2].text = item.desc  
28. document.add_page_break()    # 新增分頁符
29. document.save('demo.docx')  # 儲存這個文件

具體樣式請看：

關於更多細節希望大家還是去他的官網python-docx;看，介紹的還是很詳細

• 然後便是python-docx-template包了，他用起來就向python中的模板語言一樣，有上下文，有模板，然後進行變數的替換

關於python-docx-template，他的官網名稱便是“像jinjia2一樣來操作docx文件”，因此這個包對於用來進行文件修改時很強大的下面是一個簡單例子：

1. from docxtpl import DocxTemplate  
2. doc = DocxTemplate("1.docx")  # 對要操作的docx文件進行初始化
3. context = { 'company_name' : "World company" }   # company_name 是存在於1.docx文件裡面的變數，就像這樣{{company_name}}，直接放在1.docx檔案的明確位置就行
4. doc.render(context)   # 這裡是有jinjia2的模板語言進行變數的替換，然後便可以在1.docx文件裡面看到{{company_name}}變成了World company
5. doc.save("generated_doc.docx")   # 儲存
6. 當然，這個包的功能遠遠不止上面例子中的一些，可以包含圖片  
7. myimage = InlineImage(doc,'test_files/python_logo.png',width=Mm(20)) # tpl便是上面例子中的doc物件
8. 也可以包含另一個docx文件，  
9. sub = doc.new_subdoc()  
10. sub.subdocx = Document('d:\\2.docx')  
11. doc.render({'sub': sub})  

• 最後便是pandoc了，我在這次用到的功能主要是，用來把html檔案直接轉換為markdow格式檔案，然後再轉換為txt檔案，最後將txt檔案內容和格式一同插入到docx文件中，當然，也可以直接把html檔案轉換為docx檔案，格式基本一致

這是用到的命令，而由於使用pandoc是在控制檯下cmd或者shell使用的，因此要用到python的另一個包subprocess

1. import subprocess  
2. subprocess.call('pandoc --latex-engine=xelatex temp.html -o temp.text', cwd='d:\\python', shell=True)  
3. subprocess.call('pandoc --latex-engine=xelatex temp.text -o t1.text', cwd='d:\\python', shell=True)  

1. <span style="background-color: rgb(153, 153, 255);">subprocess.call('pandoc temp.html -o temp.docx', cwd='d:\\python', shell=True)</span>  

• 還有一個問題，若使用過程中，出現開啟docx文件報錯，那麼極有可能便是初始化模板格式錯誤，因此需要替換一個新的初始化模板

好了，主要便是這些了，謝謝檢視！