pxi4cupse
/
DjangoBlog
1
0
Fork 0
Code Issues Pull Requests 4 Packages Projects Releases Wiki Activity

yxy添加 0001_initial.py 注释

Browse Source
yxy_branch
严欣怡 4 months ago
parent 59865f0434
commit 8382776eb5
1 changed files with 123 additions and 58 deletions
Show Stats Download Patch File Download Diff File

181
djangoblog/src/DjangoBlog-master/DjangoBlog-master/blog/migrations/0001_initial.py
Unescape View File

@ -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自增，越大越新）
},
),
]
]
Write Preview
Loading…
Cancel
Save