BlogBackendProject 项目教程

1. 项目的目录结构及介绍

BlogBackendProject/
├── apps/
│   ├── __init__.py
│   ├── articles/
│   ├── atlas/
│   ├── photography/
│   └── utils/
├── extra_apps/
│   ├── __init__.py
│   ├── xadmin/
│   └── editormd/
├── media/
├── static/
├── templates/
├── .gitignore
├── qiniu_pythonsdk_hostscache.json
├── LICENSE
├── README.md
├── README_zh-cn.md
├── manage.py
└── requirements.txt

目录结构介绍

• apps/: 存放项目的各个应用模块，如文章、图集、摄影等。
• extra_apps/: 存放项目使用的第三方插件，如xadmin和editormd。
• media/: 存放上传的媒体文件。
• static/: 存放静态文件，如CSS、JavaScript等。
• templates/: 存放模板文件。
• .gitignore: Git忽略文件配置。
• qiniu_pythonsdk_hostscache.json: 七牛云SDK的缓存文件。
• LICENSE: 项目许可证文件。
• README.md: 项目的英文说明文档。
• README_zh-cn.md: 项目的中文说明文档。
• manage.py: Django项目的管理脚本。
• requirements.txt: 项目依赖的Python包列表。

2. 项目的启动文件介绍

manage.py

manage.py 是Django项目的管理脚本，用于执行各种管理任务，如启动开发服务器、创建数据库迁移、运行测试等。

常用命令

• 启动开发服务器:

  python manage.py runserver
  

• 创建数据库迁移:

  python manage.py makemigrations
  

• 应用数据库迁移:

  python manage.py migrate
  

3. 项目的配置文件介绍

settings.py

settings.py 是Django项目的主要配置文件，包含了项目的各种配置选项，如数据库配置、静态文件路径、中间件、应用列表等。

主要配置项

• SECRET_KEY: 项目的密钥，用于加密和安全相关的操作。
• DEBUG: 是否开启调试模式，开发环境中通常设置为True。
• ALLOWED_HOSTS: 允许访问的主机列表。
• INSTALLED_APPS: 项目中安装的应用列表。
• MIDDLEWARE: 项目中使用的中间件列表。
• DATABASES: 数据库配置，包括数据库引擎、名称、用户、密码、主机和端口等。
• STATIC_URL: 静态文件的URL前缀。
• MEDIA_URL: 媒体文件的URL前缀。

private.py

private.py 是项目的私有配置文件，包含了敏感的配置信息，如数据库密码、邮件服务器配置、七牛云配置等。该文件通常不会被提交到版本控制系统中。

主要配置项

• PRIVATE_SECRET_KEY: 私有密钥，用于加密和安全相关的操作。
• DATABASE_CONFIG: 数据库连接配置。
• EMAIL_CONFIG: 邮件服务器配置。
• PRIVATE_QINIU_ACCESS_KEY: 七牛云的Access Key。
• PRIVATE_QINIU_SECRET_KEY: 七牛云的Secret Key。
• PRIVATE_QINIU_BUCKET_DOMAIN: 七牛云存储桶的域名。
• PRIVATE_QINIU_BUCKET_NAME: 七牛云存储桶的名称。
• PRIVATE_MEDIA_URL_PREFIX: 访问七牛云存储资源的URL前缀。
• PRIVATE_SITE_BASE_URL: 网站的访问域名。

通过以上配置文件，可以灵活地调整项目的运行环境和功能。