Black Dashboard Django 项目教程

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

Black Dashboard Django 项目的目录结构如下：

< PROJECT ROOT >
|
|-- core/
|   |-- settings.py  # 定义全局设置
|   |-- wsgi.py      # 生产环境中启动应用
|   |-- urls.py      # 定义所有应用/节点的URL
|
|-- apps/
|   |-- home/        # 提供HTML文件的简单应用
|   |   |-- views.py # 为认证用户提供HTML页面
|   |   |-- urls.py  # 定义一些简单的路由
|   |
|   |-- authentication/  # 处理认证路由（登录和注册）
|   |   |-- urls.py      # 定义认证路由
|   |   |-- views.py     # 处理登录和注册
|   |   |-- forms.py     # 定义认证表单（登录和注册）
|
|-- static/
|   |-- <css, JS, images>  # CSS文件、JavaScript文件和图片
|
|-- templates/
|   |-- includes/          # HTML片段和组件
|   |   |-- navigation.html # 顶部菜单组件
|   |   |-- sidebar.html    # 侧边栏组件
|   |   |-- footer.html     # 应用页脚
|   |   |-- scripts.html    # 所有页面通用的脚本
|   |
|   |-- layouts/           # 主页面
|   |   |-- base-fullscreen.html # 用于认证页面
|   |   |-- base.html            # 用于通用页面
|   |
|   |-- accounts/          # 认证页面
|   |   |-- login.html     # 登录页面
|   |   |-- register.html  # 注册页面
|   |
|   |-- home/              # UI Kit页面
|   |   |-- index.html     # 首页
|   |   |-- 404-page.html  # 404页面
|   |   |-- *.html         # 其他页面
|
|-- requirements.txt       # 开发模块 - SQLite存储
|-- .env                   # 通过环境变量注入配置
|-- manage.py              # 启动应用 - Django默认启动脚本

2. 项目的启动文件介绍

项目的启动文件是 manage.py，它是 Django 项目的默认启动脚本。通过运行以下命令可以启动应用：

$ python manage.py runserver

启动后，应用将在 http://127.0.0.1:8000/ 上运行。

3. 项目的配置文件介绍

项目的配置文件主要位于 core/settings.py 中。这个文件定义了全局设置，包括数据库配置、静态文件路径、中间件、应用列表等。以下是一些关键配置项的介绍：

• DATABASES: 配置数据库连接信息，默认使用 SQLite。
• INSTALLED_APPS: 列出所有安装的应用。
• MIDDLEWARE: 列出所有中间件。
• TEMPLATES: 配置模板引擎和模板路径。
• STATIC_URL 和 STATICFILES_DIRS: 配置静态文件的路径。

通过修改 settings.py 文件，可以自定义项目的各种配置。