docs: 将sitemap.py移动到src目录并完善注释

src/sitemap.py

@@ -0,0 +1,132 @@
+"""
+DjangoBlog 站点地图配置模块
+功能：为搜索引擎提供网站结构地图，支持文章、分类、标签等内容的自动索引
+"""
+
+from django.contrib.sitemaps import Sitemap
+from django.urls import reverse
+
+from blog.models import Article, Category, Tag
+
+
+class StaticViewSitemap(Sitemap):
+    """
+    静态页面站点地图
+    用于生成固定页面的站点地图，如首页等
+    """
+    # 优先级：0.5（中等优先级，首页等重要页面可以设为1.0）
+    priority = 0.5
+    # 更新频率：每天检查
+    changefreq = 'daily'
+
+    def items(self):
+        """
+        返回包含在站点地图中的静态页面名称
+        这些名称需要与 urls.py 中的 URL 名称对应
+        """
+        return ['blog:index', ]  # 博客首页
+
+    def location(self, item):
+        """
+        根据页面名称生成完整的 URL 地址
+        """
+        return reverse(item)
+
+
+class ArticleSiteMap(Sitemap):
+    """
+    文章站点地图
+    自动生成所有已发布文章的站点地图
+    """
+    # 更新频率：每月检查（文章内容相对稳定）
+    changefreq = "monthly"
+    # 优先级：0.6（文章是核心内容，优先级较高）
+    priority = "0.6"
+
+    def items(self):
+        """
+        返回所有已发布的文章对象
+        status='p' 表示已发布状态
+        """
+        return Article.objects.filter(status='p')
+
+    def lastmod(self, obj):
+        """
+        返回文章的最后修改时间
+        帮助搜索引擎了解内容更新情况
+        """
+        return obj.last_modify_time
+
+
+class CategorySiteMap(Sitemap):
+    """
+    分类站点地图
+    生成文章分类页面的站点地图
+    """
+    # 更新频率：每周检查（分类结构相对稳定）
+    changefreq = "Weekly"
+    # 优先级：0.6（分类页面重要程度较高）
+    priority = "0.6"
+
+    def items(self):
+        """
+        返回所有分类对象
+        """
+        return Category.objects.all()
+
+    def lastmod(self, obj):
+        """
+        返回分类的最后修改时间
+        当分类下的文章更新时，分类页面也需要更新
+        """
+        return obj.last_modify_time
+
+
+class TagSiteMap(Sitemap):
+    """
+    标签站点地图
+    生成标签页面的站点地图
+    """
+    # 更新频率：每周检查
+    changefreq = "Weekly"
+    # 优先级：0.3（标签页面重要性相对较低）
+    priority = "0.3"
+
+    def items(self):
+        """
+        返回所有标签对象
+        """
+        return Tag.objects.all()
+
+    def lastmod(self, obj):
+        """
+        返回标签的最后修改时间
+        当标签关联的文章更新时，标签页面也需要更新
+        """
+        return obj.last_modify_time
+
+
+class UserSiteMap(Sitemap):
+    """
+    用户站点地图
+    生成用户主页的站点地图
+    """
+    # 更新频率：每周检查
+    changefreq = "Weekly"
+    # 优先级：0.3（用户页面重要性相对较低）
+    priority = "0.3"
+
+    def items(self):
+        """
+        返回所有发表过文章的用户（作者）
+        使用 set 去重，确保每个用户只出现一次
+        """
+        return list(set(map(lambda x: x.author, Article.objects.all())))
+
+    def lastmod(self, obj):
+        """
+        返回用户的注册时间
+        这里使用用户注册时间作为最后修改时间
+        实际可以根据用户最后活动时间优化
+        """
+        return obj.date_joined