编辑“︁Django模板基础”︁（章节）

== 核心功能详解 ==
=== 变量输出 ===
变量通过<code>{{ }}</code>语法输出，Django会尝试以下查找顺序：
1. 字典查找（<code>my_dict.key</code>）
2. 属性查找（<code>my_object.attribute</code>）
3. 方法调用（不带参数的方法）
4. 列表索引（<code>my_list.0</code>）

=== 过滤器 ===
过滤器通过管道符（<code>|</code>）对变量进行转换：
<syntaxhighlight lang="html">
<p>{{ publish_date|date:"Y-m-d" }}</p>  <!-- 输出：2023-07-15 -->
<p>{{ text|truncatechars:50 }}</p>      <!-- 截断至50字符 -->
<p>{{ value|default:"N/A" }}</p>        <!-- 默认值 -->
</syntaxhighlight>

常用内置过滤器：
* <code>length</code>：返回列表长度
* <code>lower</code>/<code>upper</code>：大小写转换
* <code>join</code>：列表连接为字符串
* <code>safe</code>：标记字符串为安全HTML

=== 控制流标签 ===
==== 条件判断 ====
<syntaxhighlight lang="html">
{% if temperature > 30 %}
    <p>Hot weather</p>
{% elif temperature > 20 %}
    <p>Pleasant weather</p>
{% else %}
    <p>Cold weather</p>
{% endif %}
</syntaxhighlight>

==== 循环 ====
<syntaxhighlight lang="html">
<ul>
{% for item in item_list %}
    <li>{{ forloop.counter }}. {{ item.name }}</li>
    {% empty %}  <!-- 当列表为空时显示 -->
    <li>No items available</li>
{% endfor %}
</ul>
</syntaxhighlight>

循环变量：
* <code>forloop.counter</code>：当前迭代次数（从1开始）
* <code>forloop.counter0</code>：从0开始的索引
* <code>forloop.revcounter</code>：剩余迭代次数

=== 模板继承 ===
Django模板系统支持类似面向对象的继承机制：

<mermaid>
graph TD
    A[base.html] -->|extends| B[child.html]
    A -->|extends| C[another_child.html]
    B -->|includes| D[header.html]
</mermaid>

基础模板（<code>base.html</code>）：
<syntaxhighlight lang="html">
<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}Default Title{% endblock %}</title>
</head>
<body>
    <div id="content">
        {% block content %}{% endblock %}
    </div>
</body>
</html>
</syntaxhighlight>

子模板（<code>child.html</code>）：
<syntaxhighlight lang="html">
{% extends "base.html" %}

{% block title %}Custom Title{% endblock %}

{% block content %}
    <h1>Main Content</h1>
    {% include "partials/navbar.html" %}
{% endblock %}
</syntaxhighlight>