构建 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 %}

登录后复制