From f77a67fe9fe2d70ec39097314a4e9c55c37bae0b Mon Sep 17 00:00:00 2001
From: pa2g3nmk9 <3474779149@qq.com>
Date: Sun, 19 Oct 2025 16:27:53 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20'src/DjangoBlog-master/tem?=
 =?UTF-8?q?plates/blog/article=5Fdetail.html'?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../templates/blog/article_detail.html        | 66 +++++++++++++------
 1 file changed, 45 insertions(+), 21 deletions(-)

diff --git a/src/DjangoBlog-master/templates/blog/article_detail.html b/src/DjangoBlog-master/templates/blog/article_detail.html
index a74a0db..79ff5a0 100644
--- a/src/DjangoBlog-master/templates/blog/article_detail.html
+++ b/src/DjangoBlog-master/templates/blog/article_detail.html
@@ -1,52 +1,76 @@
-{% extends 'share_layout/base.html' %}
-{% load blog_tags %}
+{% extends 'share_layout/base.html' %}  {# 继承基础布局模板 #}
+{% load blog_tags %}  {# 加载自定义博客标签 #}
 
 {% block header %}
+{# 文章详情页不需要特殊的header内容，使用基础模板的header #}
 {% endblock %}
+
 {% block content %}
+    {# 主要内容区域 #}
     <div id="primary" class="site-content">
         <div id="content" role="main">
+            
+            {# 加载文章详情内容 #}
             {% load_article_detail article False user %}
+            {# 参数说明：article-文章对象, False-非索引页, user-当前用户 #}
 
-            {% if article.type == 'a' %}
+            {# 文章导航（仅对文章类型显示，不包括页面等） #}
+            {% if article.type == 'a' %}  {# 如果是文章类型 #}
                 <nav class="nav-single">
-                    <h3 class="assistive-text">文章导航</h3>
-                    {% if next_article %}
-
-                        <span class="nav-previous"><a href="{{ next_article.get_absolute_url }}" rel="prev"><span
-                                class="meta-nav">&larr;</span> {{ next_article.title }}</a></span>
+                    <h3 class="assistive-text">文章导航</h3>  {# 屏幕阅读器辅助文本 #}
+                    
+                    {# 上一篇文章链接 #}
+                    {% if next_article %}  {# 注意：这里变量名可能有些反直觉，next_article实际指上一篇 #}
+                        <span class="nav-previous">
+                            <a href="{{ next_article.get_absolute_url }}" rel="prev">
+                                <span class="meta-nav">&larr;</span>  {# 左箭头 #}
+                                {{ next_article.title }}  {# 上一篇文章标题 #}
+                            </a>
+                        </span>
                     {% endif %}
-                    {% if prev_article %}
-                        <span class="nav-next"><a href="{{ prev_article.get_absolute_url }}"
-                                                  rel="next">{{ prev_article.title }} <span
-                                class="meta-nav">&rarr;</span></a></span>
+                    
+                    {# 下一篇文章链接 #}
+                    {% if prev_article %}  {# 注意：这里变量名可能有些反直觉，prev_article实际指下一篇 #}
+                        <span class="nav-next">
+                            <a href="{{ prev_article.get_absolute_url }}" rel="next">
+                                {{ prev_article.title }}  {# 下一篇文章标题 #}
+                                <span class="meta-nav">&rarr;</span>  {# 右箭头 #}
+                            </a>
+                        </span>
                     {% endif %}
                 </nav><!-- .nav-single -->
             {% endif %}
 
         </div><!-- #content -->
-        {% if article.comment_status == "o" and OPEN_SITE_COMMENT %}
-
-
+        
+        {# 评论区域 #}
+        {% if article.comment_status == "o" and OPEN_SITE_COMMENT %}  {# 如果文章开启评论且站点开启评论功能 #}
+            
+            {# 显示现有评论列表 #}
             {% include 'comments/tags/comment_list.html' %}
-            {% if user.is_authenticated %}
+            
+            {# 评论表单区域 #}
+            {% if user.is_authenticated %}  {# 用户已登录，显示评论表单 #}
                 {% include 'comments/tags/post_comment.html' %}
-            {% else %}
+            {% else %}  {# 用户未登录，显示登录提示 #}
                 <div class="comments-area">
-                    <h3 class="comment-meta">您还没有登录，请您<a
-                            href="{% url "account:login" %}?next={{ request.get_full_path }}" rel="nofollow">登录</a>后发表评论。
+                    <h3 class="comment-meta">
+                        您还没有登录，请您
+                        <a href="{% url "account:login" %}?next={{ request.get_full_path }}" rel="nofollow">登录</a>
+                        后发表评论。
                     </h3>
 
+                    {# 第三方登录选项 #}
                     {% load oauth_tags %}
                     {% load_oauth_applications request %}
-
                 </div>
             {% endif %}
         {% endif %}
     </div><!-- #primary -->
-
 {% endblock %}
 
 {% block sidebar %}
+    {# 加载侧边栏内容 #}
     {% load_sidebar user "p" %}
+    {# 参数说明：user-当前用户, "p"-可能表示文章详情页的特殊侧边栏配置 #}
 {% endblock %}
\ No newline at end of file