yxy添加 0002.py 注释

djangoblog/src/DjangoBlog-master/DjangoBlog-master/blog/migrations/0002_blogsettings_global_footer_and_more.py

@@ -1,23 +1,45 @@
-# Generated by Django 4.1.7 on 2023-03-29 06:08
-
+# 生成信息：由Django 4.1.7在2023-03-29 06:08自动生成的迁移文件
 from django.db import migrations, models
 
 
 class Migration(migrations.Migration):
+    """
+    数据库迁移类：为网站配置表添加新字段
+    用于扩展网站配置功能，支持全局头部和尾部内容的设置
+    """
 
+    # 依赖关系：当前迁移依赖于博客应用的初始迁移（0001_initial）
+    # 确保在初始表结构创建之后再执行此迁移
     dependencies = [
-        ('blog', '0001_initial'),
+        ('blog', '0001_initial'),  # 依赖blog应用的第一个迁移文件
     ]
 
+    # 迁移操作：为BlogSettings模型添加两个新字段
     operations = [
+        # 为BlogSettings添加"公共尾部"字段
         migrations.AddField(
-            model_name='blogsettings',
-            name='global_footer',
-            field=models.TextField(blank=True, default='', null=True, verbose_name='公共尾部'),
+            model_name='blogsettings',  # 目标模型：网站配置表
+            name='global_footer',  # 新字段名称
+            field=models.TextField(
+                blank=True,  # 允许表单提交为空
+                default='',  # 默认值为空字符串
+                null=True,  # 数据库中允许为NULL
+                verbose_name='公共尾部'  # 管理界面显示的字段名称
+            ),
+            # 字段作用：存储网站全局共用的尾部HTML内容（如版权信息、备案号等）
+            # 可在所有页面底部统一显示，避免重复开发
         ),
+        # 为BlogSettings添加"公共头部"字段
         migrations.AddField(
-            model_name='blogsettings',
-            name='global_header',
-            field=models.TextField(blank=True, default='', null=True, verbose_name='公共头部'),
+            model_name='blogsettings',  # 目标模型：网站配置表
+            name='global_header',  # 新字段名称
+            field=models.TextField(
+                blank=True,
+                default='',
+                null=True,
+                verbose_name='公共头部'
+            ),
+            # 字段作用：存储网站全局共用的头部HTML内容（如公共导航、统计代码等）
+            # 可在所有页面顶部统一显示，方便全局修改
         ),
-    ]
+    ]