为article_index.html写注释

src/article_index.html

@@ -0,0 +1,51 @@
+{# 继承基础模板，复用基础模板中的公共结构（如导航栏、页脚）和样式 #}
+{% extends 'share_layout/base.html' %}
+{% load blog_tags %}
+{% load cache %}
+{% block header %}
+    {% if tag_name %}
+        <title>{{ page_type }}:{{ tag_name }} | {{ SITE_DESCRIPTION }}</title>
+        {% comment %}<meta name="description" content="{{ page_type }}:{{ tag_name }}"/>{% endcomment %}
+    {% else %}
+        <title>{{ SITE_NAME }} | {{ SITE_DESCRIPTION }}</title>
+    {% endif %}
+    {# 页面元数据：设置站点SEO描述，用于搜索引擎抓取时展示的页面简介 #}
+    <meta name="description" content="{{ SITE_SEO_DESCRIPTION }}"/>
+    <meta name="keywords" content="{{ SITE_KEYWORDS }}"/>
+    <meta property="og:type" content="blog"/>
+    <meta property="og:title" content="{{ SITE_NAME }}"/>
+    <meta property="og:description" content="{{ SITE_DESCRIPTION }}"/>
+    <meta property="og:url" content="{{ SITE_BASE_URL }}"/>
+    <meta property="og:site_name" content="{{ SITE_NAME }}"/>
+{% endblock %}
+{# 定义页面主要内容（content）的内容块，承载文章列表和分页等核心内容 #}
+{% block content %}
+    <div id="primary" class="site-content">
+        <div id="content" role="main">
+            {% if page_type and tag_name %}
+                <header class="archive-header">
+
+                    <p class="archive-title">{{ page_type }}：<span>{{ tag_name }}</span></p>
+                </header><!-- .archive-header -->
+            {% endif %}
+
+         {# 循环遍历文章列表（article_list），逐个渲染文章内容 #}
+            {% for article in article_list %}
+                {% load_article_detail article True user %}
+            {% endfor %}
+
+        {# 条件判断：如果文章列表支持分页（is_paginated为True），则渲染分页控件 #}
+            {% if is_paginated %}
+                {% load_pagination_info page_obj page_type tag_name %}
+
+            {% endif %}
+        </div><!-- #content -->
+    </div><!-- #primary -->
+
+{% endblock %}
+
+{# 定义页面侧边栏（sidebar）的内容块，承载侧边栏组件 #}
+{% block sidebar %}
+    {# 调用自定义标签load_sidebar，渲染侧边栏内容 #}
+    {% load_sidebar user linktype %}
+{% endblock %}