Django Unfold 项目教程
1. 项目的目录结构及介绍
Django Unfold 项目的目录结构如下:
django-unfold/
├── unfold/
│ ├── __init__.py
│ ├── admin.py
│ ├── apps.py
│ ├── static/
│ │ └── unfold/
│ │ ├── css/
│ │ └── js/
│ ├── templates/
│ │ └── admin/
│ │ └── base_site.html
│ ├── tests/
│ │ ├── __init__.py
│ │ ├── test_admin.py
│ │ └── test_settings.py
│ └── views/
│ └── __init__.py
├── manage.py
├── README.md
└── setup.py
目录结构介绍
-
unfold/
: 项目的主目录,包含了所有的应用代码。__init__.py
: 使unfold
成为一个 Python 包。admin.py
: 自定义 Django 管理后台的配置。apps.py
: 应用的配置文件。static/
: 静态文件目录,包含 CSS 和 JS 文件。templates/
: 模板文件目录,包含自定义的管理后台模板。tests/
: 测试文件目录,包含各种测试用例。views/
: 视图文件目录,包含自定义的视图函数。
-
manage.py
: Django 项目的管理脚本。 -
README.md
: 项目的说明文档。 -
setup.py
: 项目的安装脚本。
2. 项目的启动文件介绍
manage.py
manage.py
是 Django 项目的管理脚本,用于执行各种管理命令,例如启动开发服务器、创建数据库迁移等。
#!/usr/bin/env python
import os
import sys
if __name__ == "__main__":
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "project_name.settings")
try:
from django.core.management import execute_from_command_line
except ImportError as exc:
raise ImportError(
"Couldn't import Django. Are you sure it's installed and "
"available on your PYTHONPATH environment variable? Did you "
"forget to activate a virtual environment?"
) from exc
execute_from_command_line(sys.argv)
启动开发服务器
在项目根目录下运行以下命令启动开发服务器:
python manage.py runserver
3. 项目的配置文件介绍
settings.py
settings.py
是 Django 项目的主要配置文件,包含了项目的各种配置选项。
import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
SECRET_KEY = 'your_secret_key'
DEBUG = True
ALLOWED_HOSTS = []
INSTALLED_APPS = [
'unfold',
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
]
MIDDLEWARE = [
'django.middleware.security.SecurityMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.common.CommonMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
]
ROOT_URLCONF = 'project_name.urls'
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.