diff --git a/djangoblog/src/DjangoBlog-master/DjangoBlog-master/blog/migrations/0001_initial.py b/djangoblog/src/DjangoBlog-master/DjangoBlog-master/blog/migrations/0001_initial.py index 3d391b62..66b3230d 100644 --- a/djangoblog/src/DjangoBlog-master/DjangoBlog-master/blog/migrations/0001_initial.py +++ b/djangoblog/src/DjangoBlog-master/DjangoBlog-master/blog/migrations/0001_initial.py @@ -1,137 +1,202 @@ -# Generated by Django 4.1.7 on 2023-03-02 07:14 - +# 生成信息：由Django 4.1.7在2023-03-02 07:14自动生成的迁移文件 +# 迁移文件用于定义数据库表结构，通过Django的迁移系统创建或修改数据库表 from django.conf import settings from django.db import migrations, models -import django.db.models.deletion -import django.utils.timezone -import mdeditor.fields +import django.db.models.deletion # 用于定义外键删除时的行为 +import django.utils.timezone # 用于处理时间字段的默认值 +import mdeditor.fields # 导入Markdown编辑器字段（用于文章正文） class Migration(migrations.Migration): - + """ + 数据库迁移类：定义博客系统初始表结构的迁移操作 + 所有模型的首次迁移，会创建对应的数据库表 + """ + # 标记为初始迁移（首次创建表结构） initial = True + # 依赖关系：当前迁移依赖于Django用户模型的迁移 + # 因为Article模型关联了用户表（作者），需确保用户表先创建 dependencies = [ migrations.swappable_dependency(settings.AUTH_USER_MODEL), ] + # 迁移操作：创建所有模型对应的数据库表 operations = [ + # 创建"网站配置"表（BlogSettings） migrations.CreateModel( name='BlogSettings', fields=[ + # 自增主键（BigAutoField支持更大的数值范围，适合大数据量） ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), - ('sitename', models.CharField(default='', max_length=200, verbose_name='网站名称')), - ('site_description', models.TextField(default='', max_length=1000, verbose_name='网站描述')), - ('site_seo_description', models.TextField(default='', max_length=1000, verbose_name='网站SEO描述')), - ('site_keywords', models.TextField(default='', max_length=1000, verbose_name='网站关键字')), - ('article_sub_length', models.IntegerField(default=300, verbose_name='文章摘要长度')), - ('sidebar_article_count', models.IntegerField(default=10, verbose_name='侧边栏文章数目')), - ('sidebar_comment_count', models.IntegerField(default=5, verbose_name='侧边栏评论数目')), - ('article_comment_count', models.IntegerField(default=5, verbose_name='文章页面默认显示评论数目')), - ('show_google_adsense', models.BooleanField(default=False, verbose_name='是否显示谷歌广告')), - ('google_adsense_codes', models.TextField(blank=True, default='', max_length=2000, null=True, verbose_name='广告内容')), - ('open_site_comment', models.BooleanField(default=True, verbose_name='是否打开网站评论功能')), - ('beiancode', models.CharField(blank=True, default='', max_length=2000, null=True, verbose_name='备案号')), - ('analyticscode', models.TextField(default='', max_length=1000, verbose_name='网站统计代码')), - ('show_gongan_code', models.BooleanField(default=False, verbose_name='是否显示公安备案号')), - ('gongan_beiancode', models.TextField(blank=True, default='', max_length=2000, null=True, verbose_name='公安备案号')), + ('sitename', models.CharField(default='', max_length=200, verbose_name='网站名称')), # 网站名称 + ('site_description', models.TextField(default='', max_length=1000, verbose_name='网站描述')), # 网站描述（用于前端展示） + ('site_seo_description', models.TextField(default='', max_length=1000, verbose_name='网站SEO描述')), # 用于搜索引擎优化的描述 + ('site_keywords', models.TextField(default='', max_length=1000, verbose_name='网站关键字')), # SEO关键字，多个用逗号分隔 + ('article_sub_length', models.IntegerField(default=300, verbose_name='文章摘要长度')), # 文章列表页显示的摘要长度 + ('sidebar_article_count', models.IntegerField(default=10, verbose_name='侧边栏文章数目')), # 侧边栏显示的文章数量 + ('sidebar_comment_count', models.IntegerField(default=5, verbose_name='侧边栏评论数目')), # 侧边栏显示的评论数量 + ('article_comment_count', models.IntegerField(default=5, verbose_name='文章页面默认显示评论数目')), # 文章详情页默认显示的评论数量 + ('show_google_adsense', models.BooleanField(default=False, verbose_name='是否显示谷歌广告')), # 开关：是否显示谷歌广告 + ('google_adsense_codes', models.TextField(blank=True, default='', max_length=2000, null=True, verbose_name='广告内容')), # 谷歌广告代码 + ('open_site_comment', models.BooleanField(default=True, verbose_name='是否打开网站评论功能')), # 开关：是否允许评论 + ('beiancode', models.CharField(blank=True, default='', max_length=2000, null=True, verbose_name='备案号')), # 网站备案号（ICP备案） + ('analyticscode', models.TextField(default='', max_length=1000, verbose_name='网站统计代码')), # 第三方统计代码（如百度统计） + ('show_gongan_code', models.BooleanField(default=False, verbose_name='是否显示公安备案号')), # 开关：是否显示公安备案号 + ('gongan_beiancode', models.TextField(blank=True, default='', max_length=2000, null=True, verbose_name='公安备案号')), # 公安备案号 ], options={ - 'verbose_name': '网站配置', - 'verbose_name_plural': '网站配置', + 'verbose_name': '网站配置', # 模型的单数显示名称 + 'verbose_name_plural': '网站配置', # 模型的复数显示名称（因配置通常只有一条记录，复数同单数） }, ), + + # 创建"友情链接"表（Links） migrations.CreateModel( name='Links', fields=[ ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), - ('name', models.CharField(max_length=30, unique=True, verbose_name='链接名称')), - ('link', models.URLField(verbose_name='链接地址')), - ('sequence', models.IntegerField(unique=True, verbose_name='排序')), - ('is_enable', models.BooleanField(default=True, verbose_name='是否显示')), - ('show_type', models.CharField(choices=[('i', '首页'), ('l', '列表页'), ('p', '文章页面'), ('a', '全站'), ('s', '友情链接页面')], default='i', max_length=1, verbose_name='显示类型')), - ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')), - ('last_mod_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='修改时间')), + ('name', models.CharField(max_length=30, unique=True, verbose_name='链接名称')), # 友情链接名称（唯一） + ('link', models.URLField(verbose_name='链接地址')), # 链接的URL地址 + ('sequence', models.IntegerField(unique=True, verbose_name='排序')), # 排序序号（唯一，控制显示顺序） + ('is_enable', models.BooleanField(default=True, verbose_name='是否显示')), # 开关：是否在页面显示 + # 显示类型：指定链接在哪些页面显示 + ('show_type', models.CharField( + choices=[('i', '首页'), ('l', '列表页'), ('p', '文章页面'), ('a', '全站'), ('s', '友情链接页面')], + default='i', + max_length=1, + verbose_name='显示类型' + )), + ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')), # 创建时间 + ('last_mod_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='修改时间')), # 最后修改时间 ], options={ 'verbose_name': '友情链接', 'verbose_name_plural': '友情链接', - 'ordering': ['sequence'], + 'ordering': ['sequence'], # 默认按排序序号升序排列 }, ), + + # 创建"侧边栏"表（SideBar） migrations.CreateModel( name='SideBar', fields=[ ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), - ('name', models.CharField(max_length=100, verbose_name='标题')), - ('content', models.TextField(verbose_name='内容')), - ('sequence', models.IntegerField(unique=True, verbose_name='排序')), - ('is_enable', models.BooleanField(default=True, verbose_name='是否启用')), + ('name', models.CharField(max_length=100, verbose_name='标题')), # 侧边栏模块标题 + ('content', models.TextField(verbose_name='内容')), # 侧边栏内容（支持HTML） + ('sequence', models.IntegerField(unique=True, verbose_name='排序')), # 排序序号（控制多个侧边栏的显示顺序） + ('is_enable', models.BooleanField(default=True, verbose_name='是否启用')), # 开关：是否显示该侧边栏 ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')), ('last_mod_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='修改时间')), ], options={ 'verbose_name': '侧边栏', 'verbose_name_plural': '侧边栏', - 'ordering': ['sequence'], + 'ordering': ['sequence'], # 按排序序号升序排列 }, ), + + # 创建"标签"表（Tag） migrations.CreateModel( name='Tag', fields=[ - ('id', models.AutoField(primary_key=True, serialize=False)), + ('id', models.AutoField(primary_key=True, serialize=False)), # 自增主键 ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')), ('last_mod_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='修改时间')), - ('name', models.CharField(max_length=30, unique=True, verbose_name='标签名')), - ('slug', models.SlugField(blank=True, default='no-slug', max_length=60)), + ('name', models.CharField(max_length=30, unique=True, verbose_name='标签名')), # 标签名称（唯一） + ('slug', models.SlugField(blank=True, default='no-slug', max_length=60)), # URL友好的标识符（用于生成标签页URL） ], options={ 'verbose_name': '标签', 'verbose_name_plural': '标签', - 'ordering': ['name'], + 'ordering': ['name'], # 按标签名升序排列 }, ), + + # 创建"分类"表（Category） migrations.CreateModel( name='Category', fields=[ ('id', models.AutoField(primary_key=True, serialize=False)), ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')), ('last_mod_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='修改时间')), - ('name', models.CharField(max_length=30, unique=True, verbose_name='分类名')), - ('slug', models.SlugField(blank=True, default='no-slug', max_length=60)), - ('index', models.IntegerField(default=0, verbose_name='权重排序-越大越靠前')), - ('parent_category', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='blog.category', verbose_name='父级分类')), + ('name', models.CharField(max_length=30, unique=True, verbose_name='分类名')), # 分类名称（唯一） + ('slug', models.SlugField(blank=True, default='no-slug', max_length=60)), # 用于生成分类页URL的标识符 + ('index', models.IntegerField(default=0, verbose_name='权重排序-越大越靠前')), # 权重值，控制分类在页面的显示优先级 + # 自关联外键：支持分类层级（父分类->子分类） + # on_delete=models.CASCADE表示：若父分类删除，子分类也会被删除 + ('parent_category', models.ForeignKey( + blank=True, + null=True, + on_delete=django.db.models.deletion.CASCADE, + to='blog.category', + verbose_name='父级分类' + )), ], options={ 'verbose_name': '分类', 'verbose_name_plural': '分类', - 'ordering': ['-index'], + 'ordering': ['-index'], # 按权重降序排列（权重越大越靠前） }, ), + + # 创建"文章"表（Article） migrations.CreateModel( name='Article', fields=[ ('id', models.AutoField(primary_key=True, serialize=False)), ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')), ('last_mod_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='修改时间')), - ('title', models.CharField(max_length=200, unique=True, verbose_name='标题')), - ('body', mdeditor.fields.MDTextField(verbose_name='正文')), - ('pub_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='发布时间')), - ('status', models.CharField(choices=[('d', '草稿'), ('p', '发表')], default='p', max_length=1, verbose_name='文章状态')), - ('comment_status', models.CharField(choices=[('o', '打开'), ('c', '关闭')], default='o', max_length=1, verbose_name='评论状态')), - ('type', models.CharField(choices=[('a', '文章'), ('p', '页面')], default='a', max_length=1, verbose_name='类型')), - ('views', models.PositiveIntegerField(default=0, verbose_name='浏览量')), - ('article_order', models.IntegerField(default=0, verbose_name='排序,数字越大越靠前')), - ('show_toc', models.BooleanField(default=False, verbose_name='是否显示toc目录')), - ('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='作者')), - ('category', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='blog.category', verbose_name='分类')), + ('title', models.CharField(max_length=200, unique=True, verbose_name='标题')), # 文章标题（唯一） + ('body', mdeditor.fields.MDTextField(verbose_name='正文')), # 文章正文（使用Markdown编辑器） + ('pub_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='发布时间')), # 发布时间 + # 文章状态：草稿（d）/发表（p） + ('status', models.CharField( + choices=[('d', '草稿'), ('p', '发表')], + default='p', + max_length=1, + verbose_name='文章状态' + )), + # 评论状态：打开（o）/关闭（c） + ('comment_status', models.CharField( + choices=[('o', '打开'), ('c', '关闭')], + default='o', + max_length=1, + verbose_name='评论状态' + )), + # 内容类型：文章（a）/页面（p，如关于页、联系页） + ('type', models.CharField( + choices=[('a', '文章'), ('p', '页面')], + default='a', + max_length=1, + verbose_name='类型' + )), + ('views', models.PositiveIntegerField(default=0, verbose_name='浏览量')), # 浏览量（非负整数） + ('article_order', models.IntegerField(default=0, verbose_name='排序,数字越大越靠前')), # 排序值，控制文章在列表中的位置 + ('show_toc', models.BooleanField(default=False, verbose_name='是否显示toc目录')), # 开关：是否显示文章目录 + # 外键：关联作者（Django用户模型） + # on_delete=models.CASCADE表示：若作者账号删除，其文章也会被删除 + ('author', models.ForeignKey( + on_delete=django.db.models.deletion.CASCADE, + to=settings.AUTH_USER_MODEL, + verbose_name='作者' + )), + # 外键：关联分类 + # on_delete=models.CASCADE表示：若分类删除，该分类下的文章也会被删除 + ('category', models.ForeignKey( + on_delete=django.db.models.deletion.CASCADE, + to='blog.category', + verbose_name='分类' + )), + # 多对多关系：文章与标签（一篇文章可关联多个标签，一个标签可关联多篇文章） ('tags', models.ManyToManyField(blank=True, to='blog.tag', verbose_name='标签集合')), ], options={ 'verbose_name': '文章', 'verbose_name_plural': '文章', + # 默认排序规则：先按排序值降序（值越大越靠前），再按发布时间降序（最新的在前） 'ordering': ['-article_order', '-pub_time'], - 'get_latest_by': 'id', + 'get_latest_by': 'id', # 按ID获取最新记录（ID自增，越大越新） }, ), - ] + ] \ No newline at end of file