建立 RelaxTemplates 專案：適合初學者的 Python 模板引擎-Python教學-PHP中文網

建立範本引擎可以幫助開發人員了解 Web 渲染系統的基礎。 RelaxTemplates 是一個輕量級的、基於 Python 的模板引擎，可以簡化模板渲染的過程。 RelaxTemplates 旨在具有教育性和初學者友好性，闡釋了變數替換、循環、條件、繼承和可重用片段等核心概念，使其成為想要深入了解模板引擎架構的開發人員的理想選擇。

Building the RelaxTemplates Project: A Beginner-Friendly Python Template Engine

為什麼選擇RelaxTemplates？

RelaxTemplates 的誕生是為了揭開模板引擎的神秘面紗，讓開發人員能夠探索模板功能並在其基礎上進行構建。與 Django 或 Jinja2 等生產就緒引擎不同，RelaxTemplates 強調簡單性，為用戶提供更多控制權來嘗試添加自訂或擴展功能。

RelaxTemplates 的主要特點

RelaxTemplates 提供了現代模板引擎所期望的基本功能：

變數替換：輕鬆將動態內容注入範本。
控制流（條件）：依條件渲染部分。
循環：使用 {% every %} 語法迭代列表和集合。
可呼叫函數：在模板內呼叫Python函數。
範本繼承：透過可擴充區塊實現佈局繼承。
包含：嵌入可重複使用的範本片段。

讓我們探索每個功能以及如何使用它們！

入門

要開始使用 RelaxTemplates，只需從 PyPI 安裝它：

pip install relaxtemplates

登入後複製

然後，匯入套件並定義範本檔案。 RelaxTemplates 模板是標準 HTML 文件，具有特殊語法來合併變數、區塊和其他模板邏輯。

基本語法概述

RelaxTemplates 採用簡單的語法，使用花括號和標籤來定義變數、條件、迴圈和其他範本元素：

變數包含在 {{ }} 中以進行動態替換。
區塊（例如條件和循環）包含在 {% %} 中以進行結構和控制。

模板語法和功能

變數替換

變數被包裝在 {{ }} 中，以便動態替換為所提供上下文中的值。例如，以下模板中的變數 user_name 被替換為使用者名稱。

<div>Hello, {{ user_name }}!</div>

登入後複製

當使用像 {'user_name': 'Alice'} 這樣的上下文渲染時，輸出：

pip install relaxtemplates

登入後複製

使用條件控制流程

RelaxTemplates 中的條件可讓您根據特定條件渲染內容。支援的運算子包括 >、=、

<div>Hello, {{ user_name }}!</div>

登入後複製

如果user_age大於18，則範本輸出第一則訊息；否則，它會顯示替代訊息。

循環

{% every %} 區塊迭代集合，提供了一個簡單的方法來列出項目或顯示重複部分。

<div>Hello, Alice!</div>

登入後複製

為了增加彈性，請在迴圈內使用 .. 來引用外部範圍的值。當需要當前項目以外的上下文資料時，這特別有用：

{% if user_age > 18 %}
    <p>Welcome, adult user!</p>
{% else %}
    <p>Welcome, young user!</p>
{% end %}

登入後複製

可呼叫函數

RelaxTemplates 允許您直接從範本呼叫函數。函數可以接受位置參數和關鍵字參數。

{% each items %}
    <p>{{ it }}</p>
{% end %}

登入後複製

在此範例中，在範本內呼叫 format_date 和 log，從而根據需要啟用日期格式化或日誌記錄。

模板繼承

RelaxTemplates 最強大的功能之一是它對模板繼承的支援。這允許您定義基本模板（例如標準佈局）並在子模板中擴展它。

基本模板 (base.html):

{% each items %}
    <p>Outer name: {{ ..name }}</p>
    <p>Item: {{ it }}</p>
{% end %}

登入後複製

子模板 (child.html):

<p>{% call format_date date_created %}</p>
<p>{% call log 'Event logged' level='debug' %}</p>

登入後複製

此設定可讓子範本覆蓋特定區塊，例如標題和內容，而無需重新定義整個版面配置。

包括

使用 {% include 'template_name' %} 在範本中插入可重複使用的範本片段，例如頁首或頁尾。

<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}Default Title{% endblock %}</title>
</head>
<body>
    <div id="content">
        {% block content %}Default content.{% endblock %}
    </div>
</body>
</html>

登入後複製

此功能透過將公共部分分成單獨的檔案來幫助模組化模板，減少重複並增強可讀性。

渲染範本：範例工作流程

定義範本和上下文:

首先，使用所需的變數、迴圈和條件來建立一個範本檔案。這是一個範例模板：

{% extend 'base' %}
{% block title %}Custom Page Title{% endblock %}
{% block content %}
    <p>This is custom content for the child template.</p>
{% endblock %}

登入後複製