一、项目概述与目标

• 动态个人主页的定义与核心功能（博客展示、项目集、联系表单等）
• Django框架的优势（MTV模式、ORM、Admin后台等）
• 技术栈预览（Python 3.x, Django 3.x+, Bootstrap 5, SQLite/PostgreSQL）

二、环境配置与项目初始化

• 创建虚拟环境并安装Django

python -m venv myenv
source myenv/bin/activate
pip install django
 

新建Django项目与主应用

django-admin startproject personal_site
cd personal_site
python manage.py startapp homepage
 

三、数据模型设计

• 用户模型扩展（AbstractUser）

  from django.contrib.auth.models import AbstractUser
  class CustomUser(AbstractUser):
      bio = models.TextField(blank=True)
      avatar = models.ImageField(upload_to='avatars/')
   
  

• 博客文章模型（标题、内容、发布时间、标签）
• 项目展示模型（标题、描述、GitHub链接、封面图）

四、视图与URL路由

• 基于类的视图（ListView, DetailView）展示博客和项目

  class PostListView(ListView):
      model = Post
      template_name = 'homepage/index.html'
   
  

• 动态URL配置（slug字段处理）

path('post/<slug:slug>/', PostDetailView.as_view(), name='post_detail')
 

五、模板系统与前端集成

• 基础模板继承（base.html设计）
• 静态文件配置（CSS/JS文件组织）
• 使用Django模板语言动态渲染内容

  {% for project in projects %}
    <div class="card">
      <h2>{{ project.title }}</h2>
      <p>{{ project.description|truncatechars:100 }}</p>
    </div>
  {% endfor %}
   
  

六、用户交互功能

• 联系表单实现（Form类与CSRF保护）
• 评论系统设计（ForeignKey关联用户与文章）
• 简易搜索功能（Q对象查询）

  from django.db.models import Q
  results = Post.objects.filter(
      Q(title__icontains=query) | Q(content__icontains=query)
  )
   
  

七、部署准备与优化

• 生产环境设置（DEBUG=False, ALLOWED_HOSTS）
• 静态文件收集与WhiteNoise中间件

python manage.py collectstatic
 

• 数据库迁移与Gunicorn+Nginx配置示例

八、进阶扩展方向

• REST API接口开发（DRF集成）
• 自动化测试编写（TestCase类）
• 持续集成/部署（GitHub Actions流程）

九、参考资源与后续学习

• Django官方文档关键章节链接
• 推荐插件（django-ckeditor, django-allauth）
• 同类项目GitHub仓库参考