更新 'src/DjangoBlog-master/templates/blog/article_archives.html'

src/DjangoBlog-master/templates/blog/article_archives.html

@@ -1,45 +1,59 @@
-{% extends 'share_layout/base.html' %}
-{% load blog_tags %}
-{% load cache %}
-{% load i18n %}
-{% block header %}
-
-    <title>{% trans 'article archive' %} | {{ SITE_DESCRIPTION }}</title>
+{% extends 'share_layout/base.html' %}  {# 继承基础布局模板 #}
+{% load blog_tags %}  {# 加载自定义博客标签 #}
+{% load cache %}       {# 加载缓存标签 #}
+{% load i18n %}        {# 加载国际化标签 #}
 
+{% block header %}
+    {# 页面头部元信息 #}
+    <title>{% trans 'article archive' %} |{{ SITE_DESCRIPTION }}</title>  {# 页面标题 #}
+    
+    {# SEO优化元标签 #}
     <meta name="description" content="{{ SITE_SEO_DESCRIPTION }}"/>
     <meta name="keywords" content="{{ SITE_KEYWORDS }}"/>
+    
+    {# Open Graph社交媒体元标签 #}
     <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 %}
+
 {% block content %}
+    {# 主要内容区域 #}
     <div id="primary" class="site-content">
         <div id="content" role="main">
-
+            
+            {# 页面标题区域 #}
             <header class="archive-header">
-
-                <p class="archive-title">{% trans 'article archive' %}</p>
+                <p class="archive-title">{% trans 'article archive' %}</p>  {# 翻译："文章归档" #}
             </header><!-- .archive-header -->
 
+            {# 文章归档内容 #}
             <div class="entry-content">
-
+                {# 按年份分组文章 #}
                 {% regroup article_list by pub_time.year as year_post_group %}
                 <ul>
                     {% for year in year_post_group %}
-                        <li>{{ year.grouper }} {% trans 'year' %}
+                        <li>
+                            {{ year.grouper }} {% trans 'year' %}  {# 显示年份 #}
+                            
+                            {# 按月份分组该年份下的文章 #}
                             {% regroup year.list by pub_time.month as month_post_group %}
                             <ul>
                                 {% for month in month_post_group %}
-                                    <li>{{ month.grouper }} {% trans 'month' %}
+                                    <li>
+                                        {{ month.grouper }} {% trans 'month' %}  {# 显示月份 #}
+                                        
+                                        {# 显示该月份下的所有文章 #}
                                         <ul>
                                             {% for article in month.list %}
-                                                <li><a href="{{ article.get_absolute_url }}">{{ article.title }}</a>
+                                                <li>
+                                                    <a href="{{ article.get_absolute_url }}">{{ article.title }}</a>  {# 文章链接 #}
                                                 </li>
                                             {% endfor %}
                                         </ul>
+                                        |{# 月份分隔符 #}
                                     </li>
                                 {% endfor %}
                             </ul>
@@ -49,12 +63,9 @@
             </div>
         </div><!-- #content -->
     </div><!-- #primary -->
-
 {% endblock %}
 
-
 {% block sidebar %}
-    {% load_sidebar user 'i' %}
-{% endblock %}
-
-
+    {# 侧边栏区域 #}
+    {% load_sidebar user 'i' %}  {# 加载侧边栏内容，传递用户信息和标识 #}
+{% endblock %}