# Word Template with Python

相信在大家的工作生涯當中，在一般的辦公室中最常用到的三寶應該就是Word、Excel與PowerPoint吧？像我過去在金融業，常常相關文件與簽呈等內容都必須使用Word來處理格式，以符合老人們喜歡的八股模式，相當多是需要人工排版再複製貼上，不同部門中這種重複枯燥的工作的比重不同，通常比重高的部門的可取代性高且人員素質較低，我曾經看過一整個部門都在做這種工作......，從業人員的科技技能真的應該增加。

## Python-docx-template

大家比較常看到的是python-doc，python-doc可以透過Python從零到一地建立並編寫一份Word文件，由上而下線性的建立起來，但不免的到時候某些東西還是需要人工調整，所以我必較少使用python-doc。

取而代之的是透過人工建立文件格式後，在Word文件中放入變數，到時候使用Python與Jinja2來渲染這份文件反而是更為方便直覺的，尤其像金融業有相當多既有格式的文件，這時候就不需要重新刻一個，只需要將相關參數的位置留好即可。

### 1. 安裝

```
pip install docxtpl
```

### 2. Word文件範本建立

首先我們先建立一個Word文件，並將你需要的格式先建立完成，之後我就會從這個版型做為模組帶入參數或延伸。

<figure><img src="/files/IfconQu2ZDaU9FDsm2Fj" alt=""><figcaption><p>WarrantTemplate.docx</p></figcaption></figure>

接下來就可以將我們要的變數利用Jinja2的語法插入，像是下圖中，利用兩組大括弧包起來，裡面放數變數名稱。

<figure><img src="/files/0n0FUJNhhrRud1p0ZAEn" alt=""><figcaption><p>WarrantTemplate.docx</p></figcaption></figure>

### 3. 撰寫與執行Python主程式

{% code title="main.py" lineNumbers="true" %}

```python
from docxtpl import DocxTemplate

doc  = DocxTemplate("WarrantTemplate.docx")

context = {'warrant_name': '888888',
           'underlying': '2330',
           'warrant_type': 'Call',
           'execution_type': 'European',
           'method': 'Cash Payment',
           'Duration': '10 months',
           'conversion_ratio': '10',
           'total_number': 1000000,
           'listing_date': '2023/10/01 ~ 2023/12/31'}

doc.render(context)
doc.save('Warrant01.docx')
```

{% endcode %}

執行以上程式後就可以看到在相對目錄下產生了一個Warrant01.docx的檔案，打開來看就是已經將變數導入Word文件後的成品了，是不是很簡單呢？

<figure><img src="/files/haQMJwdcbSnpBuZwRJ6x" alt=""><figcaption><p>Warrant01.docx</p></figcaption></figure>

### 補充：利用For迴圈建立多個表格

常常我們要輸出的東西絕對不止一個表格，而是可能從資料庫中抓取出來的一大堆參數，這時候就可以利用Jinja2的迴圈來一次產出多個表格。

<figure><img src="/files/TWWXenn0tIH3MlZfCxBg" alt=""><figcaption><p>WarrantTemplate.docx</p></figcaption></figure>

可以看到在表格的上下多了幾行，我想要一次產生十次一樣內容的表格，就可以直接加上這幾行，實際使用上則可以建立一個dict丟回context，透過一層一層的拆解，就可以批次產生囉！

<figure><img src="/files/8tcLDGecTMct5a6NVLx4" alt=""><figcaption><p>Warrant02.docx</p></figcaption></figure>

實際狀況就像是這樣，是不是非常簡單且直覺呢？想查看完整的功能請自行查找[python-docx-template官方文件](https://docxtpl.readthedocs.io/en/latest/)。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://go.raymondctw.dev/technology/office-automation/word-document-template.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.