Python - 模板

歡迎，有抱負的程序员們！今天，我們要深入Python中的模板世界。作為您的親切鄰居電腦科學老師，我將一步一步引導您完成這次旅程。如果您是編程新手，也別擔心——我們會從基礎開始，逐步進階。所以，來一杯咖啡（或茶，如果您喜歡），我們開始吧！

Python中的模板

模板就像文本的藍圖。想像您要給多位朋友寫信，但您想個性化每封信。您可以有一個帶有姓名和特定細節佔位符的模板，而不是每次都從頭開始寫整封信。這基本上就是編程中模板的功能！

在Python中，模板使我們能夠通過將輸出的結構與填充它的數據分離來創建動態內容。這對於生成HTML、電子郵件、報告或任何遵循一貫模式但需要填充不同數據的文本輸出非常有用。

Python的字符串模板

讓我們從Python中最簡單的模板形式開始：字符串模板。這些是Python標準庫的一部分，所以我們不需要安裝任何額外的東西。

這裡有一個簡單的例子：

from string import Template

# 創建一個模板
template = Template("Hello, $name! Welcome to $city.")

# 使用模板
result = template.substitute(name="Alice", city="Wonderland")
print(result)

如果您運行此代碼，您將看到：

Hello, Alice! Welcome to Wonderland.

讓我們來解釋一下：

1. 我們從string模塊中導入Template類。
2. 我們創建一個帶有佔位符（$name和$city）的模板字符串。
3. 我們使用substitute方法將這些佔位符替換為實際值。

很酷吧？但是如果我们想要更複雜的模板呢？這就是Jinja2的用武之地！

安裝Jinja2

Jinja2是Python的一個強大的模板引擎。它不是標準庫的一部分，所以我們需要先安裝它。別擔心，這非常容易！

打開您的終端或命令提示符，並輸入：

pip install Jinja2

就像魔法一樣，Jinja2將被安裝在您的系統上！

創建和渲染Jinja2模板

現在我們已經安裝了Jinja2，讓我們來創建一個簡單的模板並渲染它。這裡有一個例子：

from jinja2 import Template

# 創建一個Jinja2模板
template = Template("Hello, {{ name }}! You have {{ num_messages }} unread messages.")

# 渲染模板
result = template.render(name="Bob", num_messages=3)
print(result)

這將輸出：

Hello, Bob! You have 3 unread messages.

讓我們來解析這段代碼：

1. 我們從Jinja2中導入Template類。
2. 我們創建一個帶有雙花括號佔位符的模板字符串{{ }}。
3. 我們使用render方法來填充這些佔位符。

但是Jinja2能做的遠不止這些！讓我們來探索一些高級功能。

Jinja2的高級功能

Jinja2不僅僅是簡單的替換。它能夠處理循環、條件語句甚至過濾器！讓我們看一個更複雜的例子：

from jinja2 import Template

# 創建一個更複雜的模板
template = Template("""
Hello, {{ name }}!
{% if tasks %}
Your tasks for today are:
{% for task in tasks %}
- {{ task | capitalize }}
{% endfor %}
{% else %}
You have no tasks for today. Enjoy your free time!
{% endif %}
""")

# 使用不同的數據渲染模板
result1 = template.render(name="Charlie", tasks=["buy groceries", "walk the dog", "do laundry"])
result2 = template.render(name="David", tasks=[])

print(result1)
print("\n" + "=" * 30 + "\n")
print(result2)

這將輸出：

Hello, Charlie!
Your tasks for today are:
- Buy groceries
- Walk the dog
- Do laundry

==============================

Hello, David!
You have no tasks for today. Enjoy your free time!

哇，這有很多要消化！讓我們來解釋一下：

1. 我們使用{% if %}和{% else %}進行條件渲染。
2. 我們使用{% for %}循環遍歷任務。
3. 我們使用capitalize過濾器（|符號）將每個任務的第一個字母大寫。

Jinja2還有許多其他功能，包括模板繼承、宏和自定義過濾器。當您對這些基礎更加熟悉時，我鼓勵您探索這些高級功能。

以下是我們學習的一些Jinja2語法摘要：

語法	描述	示例
{{ }}	變量輸出	{{ name }}
{% %}	語句（if、for等）	{% if tasks %}
{# #}	註釋（不顯示在輸出中）	{# This is a comment #}
|	過濾器	{{ task | capitalize }}

就是這樣！您已經踏出了Python模板世界的第一步。記住，就像學習任何新技能一樣，練習才能達到完美。嘗試創建自己的模板，嘗試不同的功能，最重要的是，玩得開心！

在我們結束之前，我想起了早期教學時的一個故事。我有一個學生一開始在模板上遇到困難，但經過練習並為她的個人博客創建模板後，她最終非常喜歡它，以至於她建立了一個成功的網頁開發事業。誰知道呢？這可能也是您驚險旅程的開始！

繼續編碼，保持好奇，直到下次，模板愉快！

Credits: Image by storyset