为links_list.html写注释

src/links_list.html

@@ -0,0 +1,55 @@
+{# 继承基础模板 #}
+{% extends 'share_layout/base.html' %}
+{% load blog_tags %}
+{# 加载自定义的blog_tags模板标签库，后续可调用库中定义的自定义标签 #}
+{% load cache %}
+{% block header %}
+
+    <title>友情链接 | {{ SITE_DESCRIPTION }}</title>
+
+    <meta name="description" content="{{ SITE_SEO_DESCRIPTION }}"/>
+    <meta name="keywords" content="{{ SITE_KEYWORDS }}"/>
+    {# Open Graph（OG）协议标签：指定内容类型为“博客”，用于社交平台（如微信、微博）分享时识别内容类型 #}
+    <meta property="og:type" content="blog"/>
+    {# OG标签：社交分享时显示的标题，使用项目全局配置的站点名称（SITE_NAME） #}
+    <meta property="og:title" content="{{ SITE_NAME }}"/>
+    {# OG标签：社交分享时显示的描述，使用站点全局描述（SITE_DESCRIPTION） #}
+    <meta property="og:description" content="{{ SITE_DESCRIPTION }}"/>
+    {# OG标签：社交分享时关联的页面URL，使用项目全局配置的基础域名（SITE_BASE_URL） #}
+    <meta property="og:url" content="{{ SITE_BASE_URL }}"/>
+    {# OG标签：社交分享时显示的站点名称，与SITE_NAME保持一致 #}
+    <meta property="og:site_name" content="{{ SITE_NAME }}"/>
+
+{% endblock %}
+{# 定义页面主要内容（content）块，承载“友情链接列表”的核心展示逻辑 #}
+{% block content %}
+    {# 主要内容外层容器，通过id（primary）和class（site-content）控制样式，确保与站点整体布局统一 #}
+    <div id="primary" class="site-content">
+        <div id="content" role="main">
+
+            <header class="archive-header">
+
+                <p class="archive-title">友情链接</p>
+            </header><!-- .archive-header -->
+
+            <div class="entry-content">
+                <ul>
+                {# 循环遍历友情链接数据列表（object_list为视图传递的查询集，包含所有友情链接对象） #}
+                    {% for obj in object_list %}
+                        {# 单个友情链接项（li），每个项对应一条友情链接 #}
+                        <li>
+                            <a href="{{ obj.link }}">{{ obj.name }}</a>
+                        </li>
+                    {% endfor %} </ul>
+            </div>
+        </div><!-- #content -->
+    </div><!-- #primary -->
+
+{% endblock %}
+
+{# 定义页面侧边栏（sidebar）内容块，加载站点侧边栏组件 #}
+{% block sidebar %}
+    {% load_sidebar user 'i' %}
+{% endblock %}
+
+